@salesforce/cli 2.156.7 → 2.157.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +70 -70
  2. package/oclif.manifest.json +937 -937
  3. package/package.json +13 -13
@@ -2446,236 +2446,6 @@
2446
2446
  "promote.js"
2447
2447
  ]
2448
2448
  },
2449
- "devops:project:create": {
2450
- "aliases": [],
2451
- "args": {},
2452
- "description": "Creates a new DevOps Center project with the specified name and optional description.",
2453
- "examples": [
2454
- "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
2455
- "Create a project with a name and description.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Platform Update\" --description \"Platform services update\""
2456
- ],
2457
- "flags": {
2458
- "json": {
2459
- "description": "Format output as json.",
2460
- "helpGroup": "GLOBAL",
2461
- "name": "json",
2462
- "allowNo": false,
2463
- "type": "boolean"
2464
- },
2465
- "flags-dir": {
2466
- "helpGroup": "GLOBAL",
2467
- "name": "flags-dir",
2468
- "summary": "Import flag values from a directory.",
2469
- "hasDynamicHelp": false,
2470
- "multiple": false,
2471
- "type": "option"
2472
- },
2473
- "target-org": {
2474
- "char": "o",
2475
- "name": "target-org",
2476
- "noCacheDefault": true,
2477
- "required": true,
2478
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2479
- "hasDynamicHelp": true,
2480
- "multiple": false,
2481
- "type": "option"
2482
- },
2483
- "api-version": {
2484
- "description": "Override the api version used for api requests made by this command",
2485
- "name": "api-version",
2486
- "hasDynamicHelp": false,
2487
- "multiple": false,
2488
- "type": "option"
2489
- },
2490
- "name": {
2491
- "char": "n",
2492
- "name": "name",
2493
- "required": true,
2494
- "summary": "Name of the new DevOps Center project.",
2495
- "hasDynamicHelp": false,
2496
- "multiple": false,
2497
- "type": "option"
2498
- },
2499
- "description": {
2500
- "char": "d",
2501
- "name": "description",
2502
- "summary": "Description of the new project; if not specified, the description is blank.",
2503
- "hasDynamicHelp": false,
2504
- "multiple": false,
2505
- "type": "option"
2506
- }
2507
- },
2508
- "hasDynamicHelp": true,
2509
- "hiddenAliases": [],
2510
- "id": "devops:project:create",
2511
- "pluginAlias": "@salesforce/plugin-devops-center",
2512
- "pluginName": "@salesforce/plugin-devops-center",
2513
- "pluginType": "jit",
2514
- "strict": true,
2515
- "summary": "Create a DevOps Center project in a DevOps Center org.",
2516
- "enableJsonFlag": true,
2517
- "isESM": true,
2518
- "relativePath": [
2519
- "lib",
2520
- "commands",
2521
- "devops",
2522
- "project",
2523
- "create.js"
2524
- ]
2525
- },
2526
- "devops:project:list": {
2527
- "aliases": [],
2528
- "args": {},
2529
- "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
2530
- "examples": [
2531
- "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
2532
- "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
2533
- ],
2534
- "flags": {
2535
- "json": {
2536
- "description": "Format output as json.",
2537
- "helpGroup": "GLOBAL",
2538
- "name": "json",
2539
- "allowNo": false,
2540
- "type": "boolean"
2541
- },
2542
- "flags-dir": {
2543
- "helpGroup": "GLOBAL",
2544
- "name": "flags-dir",
2545
- "summary": "Import flag values from a directory.",
2546
- "hasDynamicHelp": false,
2547
- "multiple": false,
2548
- "type": "option"
2549
- },
2550
- "target-org": {
2551
- "char": "o",
2552
- "name": "target-org",
2553
- "noCacheDefault": true,
2554
- "required": true,
2555
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2556
- "hasDynamicHelp": true,
2557
- "multiple": false,
2558
- "type": "option"
2559
- },
2560
- "api-version": {
2561
- "description": "Override the api version used for api requests made by this command",
2562
- "name": "api-version",
2563
- "hasDynamicHelp": false,
2564
- "multiple": false,
2565
- "type": "option"
2566
- }
2567
- },
2568
- "hasDynamicHelp": true,
2569
- "hiddenAliases": [],
2570
- "id": "devops:project:list",
2571
- "pluginAlias": "@salesforce/plugin-devops-center",
2572
- "pluginName": "@salesforce/plugin-devops-center",
2573
- "pluginType": "jit",
2574
- "strict": true,
2575
- "summary": "List all DevOps Center projects in a Salesforce org.",
2576
- "enableJsonFlag": true,
2577
- "isESM": true,
2578
- "relativePath": [
2579
- "lib",
2580
- "commands",
2581
- "devops",
2582
- "project",
2583
- "list.js"
2584
- ]
2585
- },
2586
- "devops:project:update": {
2587
- "aliases": [],
2588
- "args": {},
2589
- "description": "Update the name, description, or active status of a DevOps Center project. At least one of --name, --description, or --is-active must be provided.",
2590
- "examples": [
2591
- "Rename a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"MyApp Release v2\"",
2592
- "Update the description of a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --description \"Updated release description\"",
2593
- "Deactivate a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --no-is-active",
2594
- "Update all fields at once:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"Archived App\" --description \"Archived\" --no-is-active"
2595
- ],
2596
- "flags": {
2597
- "json": {
2598
- "description": "Format output as json.",
2599
- "helpGroup": "GLOBAL",
2600
- "name": "json",
2601
- "allowNo": false,
2602
- "type": "boolean"
2603
- },
2604
- "flags-dir": {
2605
- "helpGroup": "GLOBAL",
2606
- "name": "flags-dir",
2607
- "summary": "Import flag values from a directory.",
2608
- "hasDynamicHelp": false,
2609
- "multiple": false,
2610
- "type": "option"
2611
- },
2612
- "target-org": {
2613
- "char": "o",
2614
- "name": "target-org",
2615
- "noCacheDefault": true,
2616
- "required": true,
2617
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2618
- "hasDynamicHelp": true,
2619
- "multiple": false,
2620
- "type": "option"
2621
- },
2622
- "api-version": {
2623
- "description": "Override the api version used for api requests made by this command",
2624
- "name": "api-version",
2625
- "hasDynamicHelp": false,
2626
- "multiple": false,
2627
- "type": "option"
2628
- },
2629
- "project-id": {
2630
- "char": "i",
2631
- "name": "project-id",
2632
- "required": true,
2633
- "summary": "ID of the DevOps Center project to update.",
2634
- "hasDynamicHelp": false,
2635
- "multiple": false,
2636
- "type": "option"
2637
- },
2638
- "name": {
2639
- "char": "n",
2640
- "name": "name",
2641
- "summary": "New name for the project.",
2642
- "hasDynamicHelp": false,
2643
- "multiple": false,
2644
- "type": "option"
2645
- },
2646
- "description": {
2647
- "char": "d",
2648
- "name": "description",
2649
- "summary": "New description for the project.",
2650
- "hasDynamicHelp": false,
2651
- "multiple": false,
2652
- "type": "option"
2653
- },
2654
- "is-active": {
2655
- "name": "is-active",
2656
- "summary": "Set the project active status. Use --is-active to activate or --no-is-active to deactivate.",
2657
- "allowNo": true,
2658
- "type": "boolean"
2659
- }
2660
- },
2661
- "hasDynamicHelp": true,
2662
- "hiddenAliases": [],
2663
- "id": "devops:project:update",
2664
- "pluginAlias": "@salesforce/plugin-devops-center",
2665
- "pluginName": "@salesforce/plugin-devops-center",
2666
- "pluginType": "jit",
2667
- "strict": true,
2668
- "summary": "Update a DevOps Center project.",
2669
- "enableJsonFlag": true,
2670
- "isESM": true,
2671
- "relativePath": [
2672
- "lib",
2673
- "commands",
2674
- "devops",
2675
- "project",
2676
- "update.js"
2677
- ]
2678
- },
2679
2449
  "devops:pipeline:create": {
2680
2450
  "aliases": [],
2681
2451
  "args": {},
@@ -3035,14 +2805,13 @@
3035
2805
  "update.js"
3036
2806
  ]
3037
2807
  },
3038
- "devops:promotion:complete": {
2808
+ "devops:project:create": {
3039
2809
  "aliases": [],
3040
2810
  "args": {},
3041
- "description": "Deploys work items that were merged into the pipeline branch outside of DevOps Center (externally merged) into the target stage org and updates DevOps Center records. Equivalent to the \"Complete Promotion\" action in the DevOps Center UI when a stage is out of sync.\n\nIf no undeployed work items are found for the stage, the command exits successfully with no action taken.",
2811
+ "description": "Creates a new DevOps Center project with the specified name and optional description.",
3042
2812
  "examples": [
3043
- "Complete a promotion for an out-of-sync pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
3044
- "Complete a promotion for a specific work item (e.g. first stage of a pipeline):\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
3045
- "Complete a promotion with full deploy and a specific test level:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --deploy-all --test-level RunLocalTests"
2813
+ "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
2814
+ "Create a project with a name and description.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Platform Update\" --description \"Platform services update\""
3046
2815
  ],
3047
2816
  "flags": {
3048
2817
  "json": {
@@ -3077,81 +2846,49 @@
3077
2846
  "multiple": false,
3078
2847
  "type": "option"
3079
2848
  },
3080
- "target-stage-id": {
3081
- "char": "t",
3082
- "name": "target-stage-id",
2849
+ "name": {
2850
+ "char": "n",
2851
+ "name": "name",
3083
2852
  "required": true,
3084
- "summary": "ID of the out-of-sync pipeline stage to deploy to.",
2853
+ "summary": "Name of the new DevOps Center project.",
3085
2854
  "hasDynamicHelp": false,
3086
2855
  "multiple": false,
3087
2856
  "type": "option"
3088
2857
  },
3089
- "work-item-id": {
3090
- "char": "i",
3091
- "name": "work-item-id",
3092
- "required": false,
3093
- "summary": "ID of a specific work item to deploy. Omit to deploy all undeployed work items for the stage. Use this for the first stage of a pipeline where no source stage exists.",
3094
- "hasDynamicHelp": false,
3095
- "multiple": true,
3096
- "type": "option"
3097
- },
3098
- "deploy-all": {
3099
- "char": "a",
3100
- "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
3101
- "name": "deploy-all",
3102
- "summary": "Deploy all metadata in the branch to the stage's org.",
3103
- "allowNo": false,
3104
- "type": "boolean"
3105
- },
3106
- "test-level": {
3107
- "char": "l",
3108
- "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
3109
- "name": "test-level",
3110
- "summary": "Deployment Apex testing level.",
2858
+ "description": {
2859
+ "char": "d",
2860
+ "name": "description",
2861
+ "summary": "Description of the new project; if not specified, the description is blank.",
3111
2862
  "hasDynamicHelp": false,
3112
2863
  "multiple": false,
3113
- "options": [
3114
- "NoTestRun",
3115
- "RunSpecifiedTests",
3116
- "RunLocalTests",
3117
- "RunAllTestsInOrg"
3118
- ],
3119
- "type": "option"
3120
- },
3121
- "tests": {
3122
- "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
3123
- "name": "tests",
3124
- "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
3125
- "hasDynamicHelp": false,
3126
- "multiple": true,
3127
2864
  "type": "option"
3128
2865
  }
3129
2866
  },
3130
2867
  "hasDynamicHelp": true,
3131
2868
  "hiddenAliases": [],
3132
- "id": "devops:promotion:complete",
2869
+ "id": "devops:project:create",
3133
2870
  "pluginAlias": "@salesforce/plugin-devops-center",
3134
2871
  "pluginName": "@salesforce/plugin-devops-center",
3135
2872
  "pluginType": "jit",
3136
2873
  "strict": true,
3137
- "summary": "Deploy undeployed work items to a pipeline stage org.",
2874
+ "summary": "Create a DevOps Center project in a DevOps Center org.",
3138
2875
  "enableJsonFlag": true,
3139
2876
  "isESM": true,
3140
2877
  "relativePath": [
3141
2878
  "lib",
3142
2879
  "commands",
3143
2880
  "devops",
3144
- "promotion",
3145
- "complete.js"
2881
+ "project",
2882
+ "create.js"
3146
2883
  ]
3147
2884
  },
3148
- "devops:promotion:validate": {
2885
+ "devops:project:list": {
3149
2886
  "aliases": [],
3150
2887
  "args": {},
3151
- "description": "Validates whether the specified work items can be promoted to the target pipeline stage. Checks for VCS and object permission errors before a promotion is attempted.",
2888
+ "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
3152
2889
  "examples": [
3153
- "Validate promotion of a work item to a target stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
3154
- "Validate promotion of multiple work items:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001 --work-item-id 1fk000000000002"
2890
+ "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
2891
+ "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
3155
2892
  ],
3156
2893
  "flags": {
3157
2894
  "json": {
@@ -3185,51 +2922,35 @@
3185
2922
  "hasDynamicHelp": false,
3186
2923
  "multiple": false,
3187
2924
  "type": "option"
3188
- },
3189
- "target-stage-id": {
3190
- "char": "t",
3191
- "name": "target-stage-id",
3192
- "required": true,
3193
- "summary": "ID of the target pipeline stage to validate promotion to.",
3194
- "hasDynamicHelp": false,
3195
- "multiple": false,
3196
- "type": "option"
3197
- },
3198
- "work-item-id": {
3199
- "char": "i",
3200
- "name": "work-item-id",
3201
- "required": true,
3202
- "summary": "ID of a work item to validate for promotion. Specify multiple times for multiple work items.",
3203
- "hasDynamicHelp": false,
3204
- "multiple": true,
3205
- "type": "option"
3206
2925
  }
3207
2926
  },
3208
2927
  "hasDynamicHelp": true,
3209
2928
  "hiddenAliases": [],
3210
- "id": "devops:promotion:validate",
2929
+ "id": "devops:project:list",
3211
2930
  "pluginAlias": "@salesforce/plugin-devops-center",
3212
2931
  "pluginName": "@salesforce/plugin-devops-center",
3213
2932
  "pluginType": "jit",
3214
2933
  "strict": true,
3215
- "summary": "Validate work item promotion for a pipeline stage.",
2934
+ "summary": "List all DevOps Center projects in a Salesforce org.",
3216
2935
  "enableJsonFlag": true,
3217
2936
  "isESM": true,
3218
2937
  "relativePath": [
3219
2938
  "lib",
3220
2939
  "commands",
3221
2940
  "devops",
3222
- "promotion",
3223
- "validate.js"
2941
+ "project",
2942
+ "list.js"
3224
2943
  ]
3225
2944
  },
3226
- "devops:review:create": {
2945
+ "devops:project:update": {
3227
2946
  "aliases": [],
3228
2947
  "args": {},
3229
- "description": "Creates a pull request via the Salesforce DevOps Center API, using the VCS credentials stored in the org. Works with GitHub and Bitbucket without requiring local VCS authentication.",
2948
+ "description": "Update the name, description, or active status of a DevOps Center project. At least one of --name, --description, or --is-active must be provided.",
3230
2949
  "examples": [
3231
- "Create a pull request for a work item.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
3232
- "Create a pull request using the work item ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001"
2950
+ "Rename a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"MyApp Release v2\"",
2951
+ "Update the description of a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --description \"Updated release description\"",
2952
+ "Deactivate a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --no-is-active",
2953
+ "Update all fields at once:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"Archived App\" --description \"Archived\" --no-is-active"
3233
2954
  ],
3234
2955
  "flags": {
3235
2956
  "json": {
@@ -3264,47 +2985,64 @@
3264
2985
  "multiple": false,
3265
2986
  "type": "option"
3266
2987
  },
3267
- "work-item-name": {
2988
+ "project-id": {
2989
+ "char": "i",
2990
+ "name": "project-id",
2991
+ "required": true,
2992
+ "summary": "ID of the DevOps Center project to update.",
2993
+ "hasDynamicHelp": false,
2994
+ "multiple": false,
2995
+ "type": "option"
2996
+ },
2997
+ "name": {
3268
2998
  "char": "n",
3269
- "name": "work-item-name",
3270
- "summary": "Name of the work item, such as WI-000001.",
2999
+ "name": "name",
3000
+ "summary": "New name for the project.",
3271
3001
  "hasDynamicHelp": false,
3272
3002
  "multiple": false,
3273
3003
  "type": "option"
3274
3004
  },
3275
- "work-item-id": {
3276
- "char": "w",
3277
- "name": "work-item-id",
3278
- "summary": "ID of the work item.",
3005
+ "description": {
3006
+ "char": "d",
3007
+ "name": "description",
3008
+ "summary": "New description for the project.",
3279
3009
  "hasDynamicHelp": false,
3280
3010
  "multiple": false,
3281
3011
  "type": "option"
3012
+ },
3013
+ "is-active": {
3014
+ "name": "is-active",
3015
+ "summary": "Set the project active status. Use --is-active to activate or --no-is-active to deactivate.",
3016
+ "allowNo": true,
3017
+ "type": "boolean"
3282
3018
  }
3283
3019
  },
3284
3020
  "hasDynamicHelp": true,
3285
3021
  "hiddenAliases": [],
3286
- "id": "devops:review:create",
3022
+ "id": "devops:project:update",
3287
3023
  "pluginAlias": "@salesforce/plugin-devops-center",
3288
3024
  "pluginName": "@salesforce/plugin-devops-center",
3289
3025
  "pluginType": "jit",
3290
3026
  "strict": true,
3291
- "summary": "Create a pull request for a work item branch.",
3027
+ "summary": "Update a DevOps Center project.",
3292
3028
  "enableJsonFlag": true,
3293
3029
  "isESM": true,
3294
3030
  "relativePath": [
3295
3031
  "lib",
3296
3032
  "commands",
3297
3033
  "devops",
3298
- "review",
3299
- "create.js"
3034
+ "project",
3035
+ "update.js"
3300
3036
  ]
3301
3037
  },
3302
- "devops:request:status": {
3038
+ "devops:promotion:complete": {
3303
3039
  "aliases": [],
3304
3040
  "args": {},
3305
- "description": "Returns the current status of a request identified by its request token.",
3041
+ "description": "Deploys work items that were merged into the pipeline branch outside of DevOps Center (externally merged) into the target stage org and updates DevOps Center records. Equivalent to the \"Complete Promotion\" action in the DevOps Center UI when a stage is out of sync.\n\nIf no undeployed work items are found for the stage, the command exits successfully with no action taken.",
3306
3042
  "examples": [
3307
- "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
3043
+ "Complete a promotion for an out-of-sync pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
3044
+ "Complete a promotion for a specific work item (e.g. first stage of a pipeline):\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
3045
+ "Complete a promotion with full deploy and a specific test level:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --deploy-all --test-level RunLocalTests"
3308
3046
  ],
3309
3047
  "flags": {
3310
3048
  "json": {
@@ -3339,40 +3077,81 @@
3339
3077
  "multiple": false,
3340
3078
  "type": "option"
3341
3079
  },
3342
- "request-token": {
3343
- "char": "i",
3344
- "name": "request-token",
3080
+ "target-stage-id": {
3081
+ "char": "t",
3082
+ "name": "target-stage-id",
3345
3083
  "required": true,
3346
- "summary": "Request token from the promote response.",
3084
+ "summary": "ID of the out-of-sync pipeline stage to deploy to.",
3085
+ "hasDynamicHelp": false,
3086
+ "multiple": false,
3087
+ "type": "option"
3088
+ },
3089
+ "work-item-id": {
3090
+ "char": "i",
3091
+ "name": "work-item-id",
3092
+ "required": false,
3093
+ "summary": "ID of a specific work item to deploy. Omit to deploy all undeployed work items for the stage. Use this for the first stage of a pipeline where no source stage exists.",
3094
+ "hasDynamicHelp": false,
3095
+ "multiple": true,
3096
+ "type": "option"
3097
+ },
3098
+ "deploy-all": {
3099
+ "char": "a",
3100
+ "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
3101
+ "name": "deploy-all",
3102
+ "summary": "Deploy all metadata in the branch to the stage's org.",
3103
+ "allowNo": false,
3104
+ "type": "boolean"
3105
+ },
3106
+ "test-level": {
3107
+ "char": "l",
3108
+ "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
3109
+ "name": "test-level",
3110
+ "summary": "Deployment Apex testing level.",
3347
3111
  "hasDynamicHelp": false,
3348
3112
  "multiple": false,
3113
+ "options": [
3114
+ "NoTestRun",
3115
+ "RunSpecifiedTests",
3116
+ "RunLocalTests",
3117
+ "RunAllTestsInOrg"
3118
+ ],
3119
+ "type": "option"
3120
+ },
3121
+ "tests": {
3122
+ "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
3123
+ "name": "tests",
3124
+ "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
3125
+ "hasDynamicHelp": false,
3126
+ "multiple": true,
3349
3127
  "type": "option"
3350
3128
  }
3351
3129
  },
3352
3130
  "hasDynamicHelp": true,
3353
3131
  "hiddenAliases": [],
3354
- "id": "devops:request:status",
3132
+ "id": "devops:promotion:complete",
3355
3133
  "pluginAlias": "@salesforce/plugin-devops-center",
3356
3134
  "pluginName": "@salesforce/plugin-devops-center",
3357
3135
  "pluginType": "jit",
3358
3136
  "strict": true,
3359
- "summary": "Get the status of a request.",
3137
+ "summary": "Deploy undeployed work items to a pipeline stage org.",
3360
3138
  "enableJsonFlag": true,
3361
3139
  "isESM": true,
3362
3140
  "relativePath": [
3363
3141
  "lib",
3364
3142
  "commands",
3365
3143
  "devops",
3366
- "request",
3367
- "status.js"
3144
+ "promotion",
3145
+ "complete.js"
3368
3146
  ]
3369
3147
  },
3370
- "devops:work-item:combine": {
3148
+ "devops:promotion:validate": {
3371
3149
  "aliases": [],
3372
3150
  "args": {},
3373
- "description": "Use this command when work items in the same stage share metadata or have dependencies. DevOps Center combines the selected work items so they can be promoted together during custom promotion.\n\nAfter running this command, use \"sf devops work-item promote\" with the parent work item ID to complete the promotion. The combined work items are promoted as a single unit.",
3151
+ "description": "Validates whether the specified work items can be promoted to the target pipeline stage. Checks for VCS and object permission errors before a promotion is attempted.",
3374
3152
  "examples": [
3375
- "Prepare three work items to be combined to prevent conflicts during promotion:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --parent-work-item-id 0Wx000000000001 --child-work-item-id 0Wx000000000002 --child-work-item-id 0Wx000000000003 --target-stage-id 05S000000000002"
3153
+ "Validate promotion of a work item to a target stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
3154
+ "Validate promotion of multiple work items:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001 --work-item-id 1fk000000000002"
3376
3155
  ],
3377
3156
  "flags": {
3378
3157
  "json": {
@@ -3407,59 +3186,49 @@
3407
3186
  "multiple": false,
3408
3187
  "type": "option"
3409
3188
  },
3410
- "parent-work-item-id": {
3411
- "description": "The parent work item is the primary work item that continues through the pipeline. Changes from all child work items are merged into the parent's branch during promotion.",
3412
- "name": "parent-work-item-id",
3189
+ "target-stage-id": {
3190
+ "char": "t",
3191
+ "name": "target-stage-id",
3413
3192
  "required": true,
3414
- "summary": "ID of the parent work item.",
3193
+ "summary": "ID of the target pipeline stage to validate promotion to.",
3415
3194
  "hasDynamicHelp": false,
3416
3195
  "multiple": false,
3417
3196
  "type": "option"
3418
3197
  },
3419
- "child-work-item-id": {
3420
- "description": "Specify this flag multiple times to combine multiple work items with the parent.",
3421
- "name": "child-work-item-id",
3198
+ "work-item-id": {
3199
+ "char": "i",
3200
+ "name": "work-item-id",
3422
3201
  "required": true,
3423
- "summary": "ID of a work item to combine.",
3202
+ "summary": "ID of a work item to validate for promotion. Specify multiple times for multiple work items.",
3424
3203
  "hasDynamicHelp": false,
3425
3204
  "multiple": true,
3426
3205
  "type": "option"
3427
- },
3428
- "target-stage-id": {
3429
- "char": "t",
3430
- "name": "target-stage-id",
3431
- "required": true,
3432
- "summary": "ID of the pipeline stage to promote the combined work item to.",
3433
- "hasDynamicHelp": false,
3434
- "multiple": false,
3435
- "type": "option"
3436
3206
  }
3437
3207
  },
3438
3208
  "hasDynamicHelp": true,
3439
3209
  "hiddenAliases": [],
3440
- "id": "devops:work-item:combine",
3210
+ "id": "devops:promotion:validate",
3441
3211
  "pluginAlias": "@salesforce/plugin-devops-center",
3442
3212
  "pluginName": "@salesforce/plugin-devops-center",
3443
3213
  "pluginType": "jit",
3444
3214
  "strict": true,
3445
- "summary": "Prepare work items to be combined for custom promotion.",
3215
+ "summary": "Validate work item promotion for a pipeline stage.",
3446
3216
  "enableJsonFlag": true,
3447
3217
  "isESM": true,
3448
3218
  "relativePath": [
3449
3219
  "lib",
3450
3220
  "commands",
3451
3221
  "devops",
3452
- "work-item",
3453
- "combine.js"
3222
+ "promotion",
3223
+ "validate.js"
3454
3224
  ]
3455
3225
  },
3456
- "devops:work-item:create": {
3226
+ "devops:request:status": {
3457
3227
  "aliases": [],
3458
3228
  "args": {},
3459
- "description": "The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item; run the `devops project list` command to get the IDs for all existing projects.",
3229
+ "description": "Returns the current status of a request identified by its request token.",
3460
3230
  "examples": [
3461
- "Create a work item for the project with the specified ID and give the work item the specified subject (title); use the DevOps Center org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Fix login bug\"",
3462
- "Create a work item with a subject and description:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Add dark mode\" --description \"Implement dark mode toggle in settings page\""
3231
+ "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
3463
3232
  ],
3464
3233
  "flags": {
3465
3234
  "json": {
@@ -3494,28 +3263,259 @@
3494
3263
  "multiple": false,
3495
3264
  "type": "option"
3496
3265
  },
3497
- "project-id": {
3498
- "char": "p",
3499
- "name": "project-id",
3500
- "required": true,
3501
- "summary": "ID of the DevOps Center project to create the work item in.",
3502
- "hasDynamicHelp": false,
3503
- "multiple": false,
3504
- "type": "option"
3505
- },
3506
- "subject": {
3507
- "char": "s",
3508
- "name": "subject",
3266
+ "request-token": {
3267
+ "char": "i",
3268
+ "name": "request-token",
3509
3269
  "required": true,
3510
- "summary": "Subject (title) of the new work item.",
3511
- "hasDynamicHelp": false,
3512
- "multiple": false,
3513
- "type": "option"
3514
- },
3515
- "description": {
3516
- "char": "d",
3517
- "name": "description",
3518
- "summary": "Description of the new work item; if not specified, the description is blank.",
3270
+ "summary": "Request token from the promote response.",
3271
+ "hasDynamicHelp": false,
3272
+ "multiple": false,
3273
+ "type": "option"
3274
+ }
3275
+ },
3276
+ "hasDynamicHelp": true,
3277
+ "hiddenAliases": [],
3278
+ "id": "devops:request:status",
3279
+ "pluginAlias": "@salesforce/plugin-devops-center",
3280
+ "pluginName": "@salesforce/plugin-devops-center",
3281
+ "pluginType": "jit",
3282
+ "strict": true,
3283
+ "summary": "Get the status of a request.",
3284
+ "enableJsonFlag": true,
3285
+ "isESM": true,
3286
+ "relativePath": [
3287
+ "lib",
3288
+ "commands",
3289
+ "devops",
3290
+ "request",
3291
+ "status.js"
3292
+ ]
3293
+ },
3294
+ "devops:review:create": {
3295
+ "aliases": [],
3296
+ "args": {},
3297
+ "description": "Creates a pull request via the Salesforce DevOps Center API, using the VCS credentials stored in the org. Works with GitHub and Bitbucket without requiring local VCS authentication.",
3298
+ "examples": [
3299
+ "Create a pull request for a work item.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
3300
+ "Create a pull request using the work item ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001"
3301
+ ],
3302
+ "flags": {
3303
+ "json": {
3304
+ "description": "Format output as json.",
3305
+ "helpGroup": "GLOBAL",
3306
+ "name": "json",
3307
+ "allowNo": false,
3308
+ "type": "boolean"
3309
+ },
3310
+ "flags-dir": {
3311
+ "helpGroup": "GLOBAL",
3312
+ "name": "flags-dir",
3313
+ "summary": "Import flag values from a directory.",
3314
+ "hasDynamicHelp": false,
3315
+ "multiple": false,
3316
+ "type": "option"
3317
+ },
3318
+ "target-org": {
3319
+ "char": "o",
3320
+ "name": "target-org",
3321
+ "noCacheDefault": true,
3322
+ "required": true,
3323
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3324
+ "hasDynamicHelp": true,
3325
+ "multiple": false,
3326
+ "type": "option"
3327
+ },
3328
+ "api-version": {
3329
+ "description": "Override the api version used for api requests made by this command",
3330
+ "name": "api-version",
3331
+ "hasDynamicHelp": false,
3332
+ "multiple": false,
3333
+ "type": "option"
3334
+ },
3335
+ "work-item-name": {
3336
+ "char": "n",
3337
+ "name": "work-item-name",
3338
+ "summary": "Name of the work item, such as WI-000001.",
3339
+ "hasDynamicHelp": false,
3340
+ "multiple": false,
3341
+ "type": "option"
3342
+ },
3343
+ "work-item-id": {
3344
+ "char": "w",
3345
+ "name": "work-item-id",
3346
+ "summary": "ID of the work item.",
3347
+ "hasDynamicHelp": false,
3348
+ "multiple": false,
3349
+ "type": "option"
3350
+ }
3351
+ },
3352
+ "hasDynamicHelp": true,
3353
+ "hiddenAliases": [],
3354
+ "id": "devops:review:create",
3355
+ "pluginAlias": "@salesforce/plugin-devops-center",
3356
+ "pluginName": "@salesforce/plugin-devops-center",
3357
+ "pluginType": "jit",
3358
+ "strict": true,
3359
+ "summary": "Create a pull request for a work item branch.",
3360
+ "enableJsonFlag": true,
3361
+ "isESM": true,
3362
+ "relativePath": [
3363
+ "lib",
3364
+ "commands",
3365
+ "devops",
3366
+ "review",
3367
+ "create.js"
3368
+ ]
3369
+ },
3370
+ "devops:work-item:combine": {
3371
+ "aliases": [],
3372
+ "args": {},
3373
+ "description": "Use this command when work items in the same stage share metadata or have dependencies. DevOps Center combines the selected work items so they can be promoted together during custom promotion.\n\nAfter running this command, use \"sf devops work-item promote\" with the parent work item ID to complete the promotion. The combined work items are promoted as a single unit.",
3374
+ "examples": [
3375
+ "Prepare three work items to be combined to prevent conflicts during promotion:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --parent-work-item-id 0Wx000000000001 --child-work-item-id 0Wx000000000002 --child-work-item-id 0Wx000000000003 --target-stage-id 05S000000000002"
3376
+ ],
3377
+ "flags": {
3378
+ "json": {
3379
+ "description": "Format output as json.",
3380
+ "helpGroup": "GLOBAL",
3381
+ "name": "json",
3382
+ "allowNo": false,
3383
+ "type": "boolean"
3384
+ },
3385
+ "flags-dir": {
3386
+ "helpGroup": "GLOBAL",
3387
+ "name": "flags-dir",
3388
+ "summary": "Import flag values from a directory.",
3389
+ "hasDynamicHelp": false,
3390
+ "multiple": false,
3391
+ "type": "option"
3392
+ },
3393
+ "target-org": {
3394
+ "char": "o",
3395
+ "name": "target-org",
3396
+ "noCacheDefault": true,
3397
+ "required": true,
3398
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3399
+ "hasDynamicHelp": true,
3400
+ "multiple": false,
3401
+ "type": "option"
3402
+ },
3403
+ "api-version": {
3404
+ "description": "Override the api version used for api requests made by this command",
3405
+ "name": "api-version",
3406
+ "hasDynamicHelp": false,
3407
+ "multiple": false,
3408
+ "type": "option"
3409
+ },
3410
+ "parent-work-item-id": {
3411
+ "description": "The parent work item is the primary work item that continues through the pipeline. Changes from all child work items are merged into the parent's branch during promotion.",
3412
+ "name": "parent-work-item-id",
3413
+ "required": true,
3414
+ "summary": "ID of the parent work item.",
3415
+ "hasDynamicHelp": false,
3416
+ "multiple": false,
3417
+ "type": "option"
3418
+ },
3419
+ "child-work-item-id": {
3420
+ "description": "Specify this flag multiple times to combine multiple work items with the parent.",
3421
+ "name": "child-work-item-id",
3422
+ "required": true,
3423
+ "summary": "ID of a work item to combine.",
3424
+ "hasDynamicHelp": false,
3425
+ "multiple": true,
3426
+ "type": "option"
3427
+ },
3428
+ "target-stage-id": {
3429
+ "char": "t",
3430
+ "name": "target-stage-id",
3431
+ "required": true,
3432
+ "summary": "ID of the pipeline stage to promote the combined work item to.",
3433
+ "hasDynamicHelp": false,
3434
+ "multiple": false,
3435
+ "type": "option"
3436
+ }
3437
+ },
3438
+ "hasDynamicHelp": true,
3439
+ "hiddenAliases": [],
3440
+ "id": "devops:work-item:combine",
3441
+ "pluginAlias": "@salesforce/plugin-devops-center",
3442
+ "pluginName": "@salesforce/plugin-devops-center",
3443
+ "pluginType": "jit",
3444
+ "strict": true,
3445
+ "summary": "Prepare work items to be combined for custom promotion.",
3446
+ "enableJsonFlag": true,
3447
+ "isESM": true,
3448
+ "relativePath": [
3449
+ "lib",
3450
+ "commands",
3451
+ "devops",
3452
+ "work-item",
3453
+ "combine.js"
3454
+ ]
3455
+ },
3456
+ "devops:work-item:create": {
3457
+ "aliases": [],
3458
+ "args": {},
3459
+ "description": "The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item; run the `devops project list` command to get the IDs for all existing projects.",
3460
+ "examples": [
3461
+ "Create a work item for the project with the specified ID and give the work item the specified subject (title); use the DevOps Center org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Fix login bug\"",
3462
+ "Create a work item with a subject and description:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Add dark mode\" --description \"Implement dark mode toggle in settings page\""
3463
+ ],
3464
+ "flags": {
3465
+ "json": {
3466
+ "description": "Format output as json.",
3467
+ "helpGroup": "GLOBAL",
3468
+ "name": "json",
3469
+ "allowNo": false,
3470
+ "type": "boolean"
3471
+ },
3472
+ "flags-dir": {
3473
+ "helpGroup": "GLOBAL",
3474
+ "name": "flags-dir",
3475
+ "summary": "Import flag values from a directory.",
3476
+ "hasDynamicHelp": false,
3477
+ "multiple": false,
3478
+ "type": "option"
3479
+ },
3480
+ "target-org": {
3481
+ "char": "o",
3482
+ "name": "target-org",
3483
+ "noCacheDefault": true,
3484
+ "required": true,
3485
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3486
+ "hasDynamicHelp": true,
3487
+ "multiple": false,
3488
+ "type": "option"
3489
+ },
3490
+ "api-version": {
3491
+ "description": "Override the api version used for api requests made by this command",
3492
+ "name": "api-version",
3493
+ "hasDynamicHelp": false,
3494
+ "multiple": false,
3495
+ "type": "option"
3496
+ },
3497
+ "project-id": {
3498
+ "char": "p",
3499
+ "name": "project-id",
3500
+ "required": true,
3501
+ "summary": "ID of the DevOps Center project to create the work item in.",
3502
+ "hasDynamicHelp": false,
3503
+ "multiple": false,
3504
+ "type": "option"
3505
+ },
3506
+ "subject": {
3507
+ "char": "s",
3508
+ "name": "subject",
3509
+ "required": true,
3510
+ "summary": "Subject (title) of the new work item.",
3511
+ "hasDynamicHelp": false,
3512
+ "multiple": false,
3513
+ "type": "option"
3514
+ },
3515
+ "description": {
3516
+ "char": "d",
3517
+ "name": "description",
3518
+ "summary": "Description of the new work item; if not specified, the description is blank.",
3519
3519
  "hasDynamicHelp": false,
3520
3520
  "multiple": false,
3521
3521
  "type": "option"
@@ -3788,13 +3788,12 @@
3788
3788
  "update.js"
3789
3789
  ]
3790
3790
  },
3791
- "project:deploy:pipeline:quick": {
3791
+ "devops:pipeline:project:add": {
3792
3792
  "aliases": [],
3793
3793
  "args": {},
3794
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, create a validated deployment with the \"project deploy pipeline validate\" command, which returns a job ID. Validated deployments haven't been deployed to the org yet; you deploy them with this command. Either pass the job ID to this command or use the --use-most-recent flag to use the job ID of the most recently validated deployment. For the quick deploy to succeed, the associated validated deployment must also have succeeded.\n\nExecuting this quick deploy command takes less time than a standard deploy because it skips running Apex tests. These tests were previously run as part of the validation. Validating first and then running a quick deploy is useful if the deployment to your production org take several hours and you don’t want to risk a failed deploy.\n\nThis command doesn't support source-tracking. The source you deploy overwrites the corresponding metadata in your org. This command doesn’t attempt to merge your source with the versions in your org.",
3794
+ "description": "You can attach a project to only one pipeline.",
3795
3795
  "examples": [
3796
- "Run a quick deploy using your default Devops Center org and a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
3797
- "Asynchronously run a quick deploy of the most recently validated deployment using an org with alias \"my-prod-org\":\n<%= config.bin %> <%= command.id %> --async --use-most-recent --devops-center-username my-prod-org"
3796
+ "Attach a project to a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
3798
3797
  ],
3799
3798
  "flags": {
3800
3799
  "json": {
@@ -3812,96 +3811,65 @@
3812
3811
  "multiple": false,
3813
3812
  "type": "option"
3814
3813
  },
3815
- "async": {
3816
- "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
3817
- "name": "async",
3818
- "summary": "Run the command asynchronously.",
3819
- "allowNo": false,
3820
- "type": "boolean"
3821
- },
3822
- "concise": {
3823
- "exclusive": [
3824
- "verbose"
3825
- ],
3826
- "name": "concise",
3827
- "summary": "Show concise output of the command result.",
3828
- "allowNo": false,
3829
- "type": "boolean"
3830
- },
3831
- "verbose": {
3832
- "name": "verbose",
3833
- "summary": "Show verbose output of the command result.",
3834
- "allowNo": false,
3835
- "type": "boolean"
3836
- },
3837
- "wait": {
3838
- "char": "w",
3839
- "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
3840
- "exclusive": [
3841
- "async"
3842
- ],
3843
- "name": "wait",
3844
- "summary": "Number of minutes to wait for command to complete and display results.",
3845
- "default": "33 minutes",
3814
+ "target-org": {
3815
+ "char": "o",
3816
+ "name": "target-org",
3817
+ "noCacheDefault": true,
3818
+ "required": true,
3819
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3846
3820
  "hasDynamicHelp": true,
3847
- "helpValue": "<minutes>",
3848
3821
  "multiple": false,
3849
3822
  "type": "option"
3850
3823
  },
3851
- "devops-center-username": {
3852
- "char": "c",
3853
- "name": "devops-center-username",
3854
- "required": true,
3855
- "summary": "Username or alias of the DevOps Center org.",
3856
- "hasDynamicHelp": true,
3824
+ "api-version": {
3825
+ "description": "Override the api version used for api requests made by this command",
3826
+ "name": "api-version",
3827
+ "hasDynamicHelp": false,
3857
3828
  "multiple": false,
3858
3829
  "type": "option"
3859
3830
  },
3860
- "job-id": {
3861
- "char": "i",
3862
- "description": "The job ID is valid for 10 days from when you started the validation.",
3863
- "name": "job-id",
3864
- "summary": "Job ID of the validated deployment to quick deploy.",
3831
+ "pipeline-id": {
3832
+ "name": "pipeline-id",
3833
+ "required": true,
3834
+ "summary": "ID of the pipeline.",
3865
3835
  "hasDynamicHelp": false,
3866
3836
  "multiple": false,
3867
3837
  "type": "option"
3868
3838
  },
3869
- "use-most-recent": {
3870
- "char": "r",
3871
- "description": "For performance reasons, this flag uses only job IDs that were validated in the past 3 days or less. If your most recent deployment validation was more than 3 days ago, this flag won't find the job ID.",
3872
- "name": "use-most-recent",
3873
- "summary": "Use the job ID of the most recently validated deployment.",
3874
- "allowNo": false,
3875
- "type": "boolean"
3839
+ "project-id": {
3840
+ "name": "project-id",
3841
+ "required": true,
3842
+ "summary": "ID of the DevOps Center project.",
3843
+ "hasDynamicHelp": false,
3844
+ "multiple": false,
3845
+ "type": "option"
3876
3846
  }
3877
3847
  },
3878
3848
  "hasDynamicHelp": true,
3879
3849
  "hiddenAliases": [],
3880
- "id": "project:deploy:pipeline:quick",
3850
+ "id": "devops:pipeline:project:add",
3881
3851
  "pluginAlias": "@salesforce/plugin-devops-center",
3882
3852
  "pluginName": "@salesforce/plugin-devops-center",
3883
3853
  "pluginType": "jit",
3884
- "state": "beta",
3885
3854
  "strict": true,
3886
- "summary": "Quickly deploy a validated deployment to an org.",
3855
+ "summary": "Attach a DevOps Center project to a pipeline.",
3887
3856
  "enableJsonFlag": true,
3888
3857
  "isESM": true,
3889
3858
  "relativePath": [
3890
3859
  "lib",
3891
3860
  "commands",
3892
- "project",
3893
- "deploy",
3861
+ "devops",
3894
3862
  "pipeline",
3895
- "quick.js"
3863
+ "project",
3864
+ "add.js"
3896
3865
  ]
3897
3866
  },
3898
- "project:deploy:pipeline:report": {
3867
+ "devops:pipeline:project:delete": {
3899
3868
  "aliases": [],
3900
3869
  "args": {},
3901
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nRun this command by either indicating a job ID or specifying the —use-most-recent flag to use the job ID of the most recent deploy operation.",
3870
+ "description": "Deletes the junction record that connects the project to the pipeline. The project itself is not deleted.",
3902
3871
  "examples": [
3903
- "Check the status using a job ID:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --job-id 0Af0x000017yLUFCA2",
3904
- "Check the status of the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --use-most-recent"
3872
+ "Remove a project from a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
3905
3873
  ],
3906
3874
  "flags": {
3907
3875
  "json": {
@@ -3919,60 +3887,66 @@
3919
3887
  "multiple": false,
3920
3888
  "type": "option"
3921
3889
  },
3922
- "devops-center-username": {
3923
- "char": "c",
3924
- "name": "devops-center-username",
3890
+ "target-org": {
3891
+ "char": "o",
3892
+ "name": "target-org",
3893
+ "noCacheDefault": true,
3925
3894
  "required": true,
3926
- "summary": "Username or alias of the DevOps Center org.",
3895
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3927
3896
  "hasDynamicHelp": true,
3928
3897
  "multiple": false,
3929
3898
  "type": "option"
3930
3899
  },
3931
- "job-id": {
3932
- "char": "i",
3933
- "description": "The job ID is valid for 10 days from when you started the deploy operation.",
3934
- "name": "job-id",
3935
- "summary": "Job ID of the pipeline deployment to check the status of.",
3900
+ "api-version": {
3901
+ "description": "Override the api version used for api requests made by this command",
3902
+ "name": "api-version",
3936
3903
  "hasDynamicHelp": false,
3937
3904
  "multiple": false,
3938
3905
  "type": "option"
3939
3906
  },
3940
- "use-most-recent": {
3941
- "char": "r",
3942
- "description": "For performance reasons, this flag uses job IDs for deploy operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find the job ID.",
3943
- "name": "use-most-recent",
3944
- "summary": "Use the job ID of the most recent deploy operation.",
3945
- "allowNo": false,
3946
- "type": "boolean"
3907
+ "pipeline-id": {
3908
+ "name": "pipeline-id",
3909
+ "required": true,
3910
+ "summary": "ID of the pipeline.",
3911
+ "hasDynamicHelp": false,
3912
+ "multiple": false,
3913
+ "type": "option"
3914
+ },
3915
+ "project-id": {
3916
+ "name": "project-id",
3917
+ "required": true,
3918
+ "summary": "ID of the DevOps Center project.",
3919
+ "hasDynamicHelp": false,
3920
+ "multiple": false,
3921
+ "type": "option"
3947
3922
  }
3948
3923
  },
3949
3924
  "hasDynamicHelp": true,
3950
3925
  "hiddenAliases": [],
3951
- "id": "project:deploy:pipeline:report",
3926
+ "id": "devops:pipeline:project:delete",
3952
3927
  "pluginAlias": "@salesforce/plugin-devops-center",
3953
3928
  "pluginName": "@salesforce/plugin-devops-center",
3954
3929
  "pluginType": "jit",
3955
- "state": "beta",
3956
3930
  "strict": true,
3957
- "summary": "Check the status of a pipeline deploy operation.",
3931
+ "summary": "Remove a DevOps Center project's connection to a pipeline.",
3958
3932
  "enableJsonFlag": true,
3959
3933
  "isESM": true,
3960
3934
  "relativePath": [
3961
3935
  "lib",
3962
3936
  "commands",
3963
- "project",
3964
- "deploy",
3937
+ "devops",
3965
3938
  "pipeline",
3966
- "report.js"
3939
+ "project",
3940
+ "delete.js"
3967
3941
  ]
3968
3942
  },
3969
- "project:deploy:pipeline:resume": {
3943
+ "devops:pipeline:stage:add": {
3970
3944
  "aliases": [],
3971
3945
  "args": {},
3972
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command. \n\nUse this command to resume watching a pipeline deploy operation if the original command times out or you specified the --async flag.\n\nRun this command by either indicating a job ID or specifying the --use-most-recent flag to use the job ID of the most recent deploy operation.",
3946
+ "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
3973
3947
  "examples": [
3974
- "Resume watching a deploy operation using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
3975
- "Resume watching the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --use-most-recent"
3948
+ "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
3949
+ "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
3976
3950
  ],
3977
3951
  "flags": {
3978
3952
  "json": {
@@ -3990,89 +3964,74 @@
3990
3964
  "multiple": false,
3991
3965
  "type": "option"
3992
3966
  },
3993
- "devops-center-username": {
3994
- "char": "c",
3995
- "name": "devops-center-username",
3967
+ "target-org": {
3968
+ "char": "o",
3969
+ "name": "target-org",
3970
+ "noCacheDefault": true,
3996
3971
  "required": true,
3997
- "summary": "Username or alias of the DevOps Center org.",
3972
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3998
3973
  "hasDynamicHelp": true,
3999
3974
  "multiple": false,
4000
3975
  "type": "option"
4001
3976
  },
4002
- "job-id": {
4003
- "char": "i",
4004
- "description": "These commands return a job ID if they time out or you specified the --async flag:\n\n- sf project deploy pipeline start\n- sf project deploy pipeline validate\n- sf project deploy pipeline quick\n\nThe job ID is valid for 10 days from when you started the deploy operation.",
4005
- "name": "job-id",
4006
- "summary": "Job ID of the pipeline deploy operation you want to resume.",
3977
+ "api-version": {
3978
+ "description": "Override the api version used for api requests made by this command",
3979
+ "name": "api-version",
4007
3980
  "hasDynamicHelp": false,
4008
3981
  "multiple": false,
4009
3982
  "type": "option"
4010
3983
  },
4011
- "use-most-recent": {
4012
- "char": "r",
4013
- "description": "For performance reasons, this flag uses job IDs for operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find a job ID.",
4014
- "name": "use-most-recent",
4015
- "summary": "Use the job ID of the most recent deploy operation.",
4016
- "allowNo": false,
4017
- "type": "boolean"
4018
- },
4019
- "concise": {
4020
- "exclusive": [
4021
- "verbose"
4022
- ],
4023
- "name": "concise",
4024
- "summary": "Show concise output of the command result.",
4025
- "allowNo": false,
4026
- "type": "boolean"
3984
+ "pipeline-id": {
3985
+ "name": "pipeline-id",
3986
+ "required": true,
3987
+ "summary": "ID of the pipeline where the stage is added.",
3988
+ "hasDynamicHelp": false,
3989
+ "multiple": false,
3990
+ "type": "option"
4027
3991
  },
4028
- "verbose": {
4029
- "name": "verbose",
4030
- "summary": "Show verbose output of the command result.",
4031
- "allowNo": false,
4032
- "type": "boolean"
3992
+ "name": {
3993
+ "char": "n",
3994
+ "name": "name",
3995
+ "required": true,
3996
+ "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
3997
+ "hasDynamicHelp": false,
3998
+ "multiple": false,
3999
+ "type": "option"
4033
4000
  },
4034
- "wait": {
4035
- "char": "w",
4036
- "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
4037
- "exclusive": [
4038
- "async"
4039
- ],
4040
- "name": "wait",
4041
- "summary": "Number of minutes to wait for command to complete and display results.",
4042
- "default": "33 minutes",
4043
- "hasDynamicHelp": true,
4044
- "helpValue": "<minutes>",
4001
+ "next-stage-id": {
4002
+ "name": "next-stage-id",
4003
+ "required": true,
4004
+ "summary": "ID of the stage that follows the new stage in the pipeline.",
4005
+ "hasDynamicHelp": false,
4045
4006
  "multiple": false,
4046
4007
  "type": "option"
4047
4008
  }
4048
4009
  },
4049
4010
  "hasDynamicHelp": true,
4050
4011
  "hiddenAliases": [],
4051
- "id": "project:deploy:pipeline:resume",
4012
+ "id": "devops:pipeline:stage:add",
4052
4013
  "pluginAlias": "@salesforce/plugin-devops-center",
4053
4014
  "pluginName": "@salesforce/plugin-devops-center",
4054
4015
  "pluginType": "jit",
4055
- "state": "beta",
4056
4016
  "strict": true,
4057
- "summary": "Resume watching a pipeline deploy operation.",
4017
+ "summary": "Add a stage to a DevOps Center pipeline.",
4058
4018
  "enableJsonFlag": true,
4059
4019
  "isESM": true,
4060
4020
  "relativePath": [
4061
4021
  "lib",
4062
4022
  "commands",
4063
- "project",
4064
- "deploy",
4023
+ "devops",
4065
4024
  "pipeline",
4066
- "resume.js"
4025
+ "stage",
4026
+ "add.js"
4067
4027
  ]
4068
4028
  },
4069
- "project:deploy:pipeline:start": {
4029
+ "devops:pipeline:stage:delete": {
4070
4030
  "aliases": [],
4071
4031
  "args": {},
4072
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, changes in the pipeline stage's branch must be merged in the source control repository.",
4032
+ "description": "Deletes the specified stage from the pipeline. If the stage sits between two other stages, the predecessor stage is automatically re-linked to the successor so the pipeline chain stays intact.",
4073
4033
  "examples": [
4074
- "Deploy changes in the Staging branch to the Staging environment (sandbox), if the previous stage is the bundling stage:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox --bundle-version-name 1.0",
4075
- "Deploy all changes in the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
4034
+ "Delete a stage from a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000002"
4076
4035
  ],
4077
4036
  "flags": {
4078
4037
  "json": {
@@ -4090,138 +4049,65 @@
4090
4049
  "multiple": false,
4091
4050
  "type": "option"
4092
4051
  },
4093
- "branch-name": {
4094
- "char": "b",
4095
- "name": "branch-name",
4052
+ "target-org": {
4053
+ "char": "o",
4054
+ "name": "target-org",
4055
+ "noCacheDefault": true,
4096
4056
  "required": true,
4097
- "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
4098
- "hasDynamicHelp": false,
4057
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
4058
+ "hasDynamicHelp": true,
4099
4059
  "multiple": false,
4100
4060
  "type": "option"
4101
4061
  },
4102
- "bundle-version-name": {
4103
- "char": "v",
4104
- "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
4105
- "name": "bundle-version-name",
4106
- "summary": "Version name of the bundle.",
4062
+ "api-version": {
4063
+ "description": "Override the api version used for api requests made by this command",
4064
+ "name": "api-version",
4107
4065
  "hasDynamicHelp": false,
4108
4066
  "multiple": false,
4109
4067
  "type": "option"
4110
4068
  },
4111
- "deploy-all": {
4112
- "char": "a",
4113
- "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
4114
- "name": "deploy-all",
4115
- "summary": "Deploy all metadata in the branch to the stage's org.",
4116
- "allowNo": false,
4117
- "type": "boolean"
4118
- },
4119
- "devops-center-project-name": {
4120
- "char": "p",
4121
- "name": "devops-center-project-name",
4069
+ "pipeline-id": {
4070
+ "name": "pipeline-id",
4122
4071
  "required": true,
4123
- "summary": "Name of the DevOps Center project.",
4072
+ "summary": "ID of the pipeline that contains the stage.",
4124
4073
  "hasDynamicHelp": false,
4125
4074
  "multiple": false,
4126
4075
  "type": "option"
4127
4076
  },
4128
- "devops-center-username": {
4129
- "char": "c",
4130
- "name": "devops-center-username",
4077
+ "stage-id": {
4078
+ "name": "stage-id",
4131
4079
  "required": true,
4132
- "summary": "Username or alias of the DevOps Center org.",
4133
- "hasDynamicHelp": true,
4134
- "multiple": false,
4135
- "type": "option"
4136
- },
4137
- "tests": {
4138
- "char": "t",
4139
- "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
4140
- "name": "tests",
4141
- "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
4142
- "hasDynamicHelp": false,
4143
- "multiple": true,
4144
- "type": "option"
4145
- },
4146
- "test-level": {
4147
- "char": "l",
4148
- "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
4149
- "name": "test-level",
4150
- "summary": "Deployment Apex testing level.",
4080
+ "summary": "ID of the stage to delete.",
4151
4081
  "hasDynamicHelp": false,
4152
4082
  "multiple": false,
4153
- "options": [
4154
- "NoTestRun",
4155
- "RunSpecifiedTests",
4156
- "RunLocalTests",
4157
- "RunAllTestsInOrg"
4158
- ],
4159
- "type": "option"
4160
- },
4161
- "async": {
4162
- "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
4163
- "name": "async",
4164
- "summary": "Run the command asynchronously.",
4165
- "allowNo": false,
4166
- "type": "boolean"
4167
- },
4168
- "wait": {
4169
- "char": "w",
4170
- "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
4171
- "exclusive": [
4172
- "async"
4173
- ],
4174
- "name": "wait",
4175
- "summary": "Number of minutes to wait for command to complete and display results.",
4176
- "default": "33 minutes",
4177
- "hasDynamicHelp": true,
4178
- "helpValue": "<minutes>",
4179
- "multiple": false,
4180
4083
  "type": "option"
4181
- },
4182
- "verbose": {
4183
- "name": "verbose",
4184
- "summary": "Show verbose output of the command result.",
4185
- "allowNo": false,
4186
- "type": "boolean"
4187
- },
4188
- "concise": {
4189
- "exclusive": [
4190
- "verbose"
4191
- ],
4192
- "name": "concise",
4193
- "summary": "Show concise output of the command result.",
4194
- "allowNo": false,
4195
- "type": "boolean"
4196
4084
  }
4197
4085
  },
4198
4086
  "hasDynamicHelp": true,
4199
4087
  "hiddenAliases": [],
4200
- "id": "project:deploy:pipeline:start",
4088
+ "id": "devops:pipeline:stage:delete",
4201
4089
  "pluginAlias": "@salesforce/plugin-devops-center",
4202
4090
  "pluginName": "@salesforce/plugin-devops-center",
4203
4091
  "pluginType": "jit",
4204
- "state": "beta",
4205
4092
  "strict": true,
4206
- "summary": "Deploy changes from a branch to the pipeline stage’s org.",
4093
+ "summary": "Delete a stage from a DevOps Center pipeline.",
4207
4094
  "enableJsonFlag": true,
4208
4095
  "isESM": true,
4209
4096
  "relativePath": [
4210
4097
  "lib",
4211
4098
  "commands",
4212
- "project",
4213
- "deploy",
4099
+ "devops",
4214
4100
  "pipeline",
4215
- "start.js"
4101
+ "stage",
4102
+ "delete.js"
4216
4103
  ]
4217
4104
  },
4218
- "project:deploy:pipeline:validate": {
4105
+ "devops:pipeline:stage:update": {
4219
4106
  "aliases": [],
4220
4107
  "args": {},
4221
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nA validation runs Apex tests to verify whether a deployment will succeed without actually deploying the metadata to your environment, so you can then quickly deploy the changes later without re-running the tests.",
4108
+ "description": "Updates the name of a pipeline stage.",
4222
4109
  "examples": [
4223
- "Perform a validate-only deployment from the Staging branch to the Staging environment (sandbox):\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox",
4224
- "Perform a validate-only deployment of all changes from the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
4110
+ "Rename a pipeline stage.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QV000000000001 --name \"Integration\""
4225
4111
  ],
4226
4112
  "flags": {
4227
4113
  "json": {
@@ -4239,137 +4125,68 @@
4239
4125
  "multiple": false,
4240
4126
  "type": "option"
4241
4127
  },
4242
- "branch-name": {
4243
- "char": "b",
4244
- "name": "branch-name",
4128
+ "target-org": {
4129
+ "char": "o",
4130
+ "name": "target-org",
4131
+ "noCacheDefault": true,
4245
4132
  "required": true,
4246
- "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
4247
- "hasDynamicHelp": false,
4133
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
4134
+ "hasDynamicHelp": true,
4248
4135
  "multiple": false,
4249
4136
  "type": "option"
4250
4137
  },
4251
- "bundle-version-name": {
4252
- "char": "v",
4253
- "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
4254
- "name": "bundle-version-name",
4255
- "summary": "Version name of the bundle.",
4138
+ "api-version": {
4139
+ "description": "Override the api version used for api requests made by this command",
4140
+ "name": "api-version",
4256
4141
  "hasDynamicHelp": false,
4257
4142
  "multiple": false,
4258
4143
  "type": "option"
4259
4144
  },
4260
- "deploy-all": {
4261
- "char": "a",
4262
- "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
4263
- "name": "deploy-all",
4264
- "summary": "Deploy all metadata in the branch to the stage's org.",
4265
- "allowNo": false,
4266
- "type": "boolean"
4267
- },
4268
- "devops-center-project-name": {
4269
- "char": "p",
4270
- "name": "devops-center-project-name",
4145
+ "stage-id": {
4146
+ "char": "s",
4147
+ "name": "stage-id",
4271
4148
  "required": true,
4272
- "summary": "Name of the DevOps Center project.",
4149
+ "summary": "ID of the pipeline stage to update.",
4273
4150
  "hasDynamicHelp": false,
4274
4151
  "multiple": false,
4275
4152
  "type": "option"
4276
4153
  },
4277
- "devops-center-username": {
4278
- "char": "c",
4279
- "name": "devops-center-username",
4154
+ "name": {
4155
+ "char": "n",
4156
+ "name": "name",
4280
4157
  "required": true,
4281
- "summary": "Username or alias of the DevOps Center org.",
4282
- "hasDynamicHelp": true,
4283
- "multiple": false,
4284
- "type": "option"
4285
- },
4286
- "tests": {
4287
- "char": "t",
4288
- "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
4289
- "name": "tests",
4290
- "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
4291
- "hasDynamicHelp": false,
4292
- "multiple": true,
4293
- "type": "option"
4294
- },
4295
- "test-level": {
4296
- "char": "l",
4297
- "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
4298
- "name": "test-level",
4299
- "summary": "Deployment Apex testing level.",
4158
+ "summary": "New name for the pipeline stage.",
4300
4159
  "hasDynamicHelp": false,
4301
4160
  "multiple": false,
4302
- "options": [
4303
- "NoTestRun",
4304
- "RunSpecifiedTests",
4305
- "RunLocalTests",
4306
- "RunAllTestsInOrg"
4307
- ],
4308
- "type": "option"
4309
- },
4310
- "async": {
4311
- "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
4312
- "name": "async",
4313
- "summary": "Run the command asynchronously.",
4314
- "allowNo": false,
4315
- "type": "boolean"
4316
- },
4317
- "wait": {
4318
- "char": "w",
4319
- "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
4320
- "exclusive": [
4321
- "async"
4322
- ],
4323
- "name": "wait",
4324
- "summary": "Number of minutes to wait for command to complete and display results.",
4325
- "default": "33 minutes",
4326
- "hasDynamicHelp": true,
4327
- "helpValue": "<minutes>",
4328
- "multiple": false,
4329
4161
  "type": "option"
4330
- },
4331
- "verbose": {
4332
- "name": "verbose",
4333
- "summary": "Show verbose output of the command result.",
4334
- "allowNo": false,
4335
- "type": "boolean"
4336
- },
4337
- "concise": {
4338
- "exclusive": [
4339
- "verbose"
4340
- ],
4341
- "name": "concise",
4342
- "summary": "Show concise output of the command result.",
4343
- "allowNo": false,
4344
- "type": "boolean"
4345
4162
  }
4346
4163
  },
4347
4164
  "hasDynamicHelp": true,
4348
4165
  "hiddenAliases": [],
4349
- "id": "project:deploy:pipeline:validate",
4166
+ "id": "devops:pipeline:stage:update",
4350
4167
  "pluginAlias": "@salesforce/plugin-devops-center",
4351
4168
  "pluginName": "@salesforce/plugin-devops-center",
4352
4169
  "pluginType": "jit",
4353
- "state": "beta",
4354
4170
  "strict": true,
4355
- "summary": "Perform a validate-only deployment from a branch to the pipeline stage’s org.",
4171
+ "summary": "Update a DevOps Center pipeline stage.",
4356
4172
  "enableJsonFlag": true,
4357
4173
  "isESM": true,
4358
4174
  "relativePath": [
4359
4175
  "lib",
4360
4176
  "commands",
4361
- "project",
4362
- "deploy",
4177
+ "devops",
4363
4178
  "pipeline",
4364
- "validate.js"
4179
+ "stage",
4180
+ "update.js"
4365
4181
  ]
4366
4182
  },
4367
- "devops:pipeline:project:add": {
4183
+ "devops:stage:branch:add": {
4368
4184
  "aliases": [],
4369
4185
  "args": {},
4370
- "description": "You can attach a project to only one pipeline.",
4186
+ "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. If the stage already has a branch, the command blocks so the existing branch isn't orphaned; pass --force to replace it.",
4371
4187
  "examples": [
4372
- "Attach a project to a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
4188
+ "Add an existing branch to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main",
4189
+ "Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
4373
4190
  ],
4374
4191
  "flags": {
4375
4192
  "json": {
@@ -4407,45 +4224,66 @@
4407
4224
  "pipeline-id": {
4408
4225
  "name": "pipeline-id",
4409
4226
  "required": true,
4410
- "summary": "ID of the pipeline.",
4227
+ "summary": "ID of the pipeline that contains the stage.",
4411
4228
  "hasDynamicHelp": false,
4412
4229
  "multiple": false,
4413
4230
  "type": "option"
4414
4231
  },
4415
- "project-id": {
4416
- "name": "project-id",
4232
+ "stage-id": {
4233
+ "name": "stage-id",
4417
4234
  "required": true,
4418
- "summary": "ID of the DevOps Center project.",
4235
+ "summary": "ID of the pipeline stage to associate the branch with.",
4236
+ "hasDynamicHelp": false,
4237
+ "multiple": false,
4238
+ "type": "option"
4239
+ },
4240
+ "branch-name": {
4241
+ "char": "b",
4242
+ "name": "branch-name",
4243
+ "required": true,
4244
+ "summary": "Name of the repository branch to assign to the stage.",
4419
4245
  "hasDynamicHelp": false,
4420
4246
  "multiple": false,
4421
4247
  "type": "option"
4248
+ },
4249
+ "create-vcs-branch": {
4250
+ "name": "create-vcs-branch",
4251
+ "summary": "Create the branch in the remote repository if it doesn't already exist.",
4252
+ "allowNo": false,
4253
+ "type": "boolean"
4254
+ },
4255
+ "force": {
4256
+ "name": "force",
4257
+ "summary": "Replace the stage's existing branch. By default, the command blocks if the stage already has a branch to avoid orphaning it. With this flag, the new branch is associated and the previous branch record is removed if no other stage references it.",
4258
+ "allowNo": false,
4259
+ "type": "boolean"
4422
4260
  }
4423
4261
  },
4424
4262
  "hasDynamicHelp": true,
4425
4263
  "hiddenAliases": [],
4426
- "id": "devops:pipeline:project:add",
4264
+ "id": "devops:stage:branch:add",
4427
4265
  "pluginAlias": "@salesforce/plugin-devops-center",
4428
4266
  "pluginName": "@salesforce/plugin-devops-center",
4429
4267
  "pluginType": "jit",
4430
4268
  "strict": true,
4431
- "summary": "Attach a DevOps Center project to a pipeline.",
4269
+ "summary": "Add a source code repository branch to a pipeline stage.",
4432
4270
  "enableJsonFlag": true,
4433
4271
  "isESM": true,
4434
4272
  "relativePath": [
4435
4273
  "lib",
4436
4274
  "commands",
4437
4275
  "devops",
4438
- "pipeline",
4439
- "project",
4276
+ "stage",
4277
+ "branch",
4440
4278
  "add.js"
4441
4279
  ]
4442
4280
  },
4443
- "devops:pipeline:project:delete": {
4281
+ "devops:stage:branch:delete": {
4444
4282
  "aliases": [],
4445
4283
  "args": {},
4446
- "description": "Deletes the junction record that connects the project to the pipeline. The project itself is not deleted.",
4284
+ "description": "Removes the branch linked to the specified pipeline stage. Because branches are configured from right to left (a stage can have a branch only after the stage to its right does), removing a branch also removes the branches from all upstream stages (to the left) in the pipeline, keeping it in a valid state. The branch records in the repository are not deleted; only their association with the stages is removed. The stage must belong to an inactive pipeline.",
4447
4285
  "examples": [
4448
- "Remove a project from a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
4286
+ "Delete the branch associated with a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001"
4449
4287
  ],
4450
4288
  "flags": {
4451
4289
  "json": {
@@ -4483,15 +4321,15 @@
4483
4321
  "pipeline-id": {
4484
4322
  "name": "pipeline-id",
4485
4323
  "required": true,
4486
- "summary": "ID of the pipeline.",
4324
+ "summary": "ID of the pipeline that contains the stage. Used to verify the pipeline is inactive before deleting.",
4487
4325
  "hasDynamicHelp": false,
4488
4326
  "multiple": false,
4489
4327
  "type": "option"
4490
4328
  },
4491
- "project-id": {
4492
- "name": "project-id",
4329
+ "stage-id": {
4330
+ "name": "stage-id",
4493
4331
  "required": true,
4494
- "summary": "ID of the DevOps Center project.",
4332
+ "summary": "ID of the pipeline stage whose branch you want to delete.",
4495
4333
  "hasDynamicHelp": false,
4496
4334
  "multiple": false,
4497
4335
  "type": "option"
@@ -4499,30 +4337,29 @@
4499
4337
  },
4500
4338
  "hasDynamicHelp": true,
4501
4339
  "hiddenAliases": [],
4502
- "id": "devops:pipeline:project:delete",
4340
+ "id": "devops:stage:branch:delete",
4503
4341
  "pluginAlias": "@salesforce/plugin-devops-center",
4504
4342
  "pluginName": "@salesforce/plugin-devops-center",
4505
4343
  "pluginType": "jit",
4506
4344
  "strict": true,
4507
- "summary": "Remove a DevOps Center project's connection to a pipeline.",
4345
+ "summary": "Delete the source code repository branch associated with a pipeline stage.",
4508
4346
  "enableJsonFlag": true,
4509
4347
  "isESM": true,
4510
4348
  "relativePath": [
4511
4349
  "lib",
4512
4350
  "commands",
4513
4351
  "devops",
4514
- "pipeline",
4515
- "project",
4352
+ "stage",
4353
+ "branch",
4516
4354
  "delete.js"
4517
4355
  ]
4518
4356
  },
4519
- "devops:pipeline:stage:add": {
4357
+ "devops:stage:environment:add": {
4520
4358
  "aliases": [],
4521
4359
  "args": {},
4522
- "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
4360
+ "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
4523
4361
  "examples": [
4524
- "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
4525
- "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
4362
+ "Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
4526
4363
  ],
4527
4364
  "flags": {
4528
4365
  "json": {
@@ -4560,54 +4397,78 @@
4560
4397
  "pipeline-id": {
4561
4398
  "name": "pipeline-id",
4562
4399
  "required": true,
4563
- "summary": "ID of the pipeline where the stage is added.",
4400
+ "summary": "ID of the pipeline that contains the stage.",
4564
4401
  "hasDynamicHelp": false,
4565
4402
  "multiple": false,
4566
4403
  "type": "option"
4567
4404
  },
4568
- "name": {
4569
- "char": "n",
4570
- "name": "name",
4405
+ "stage-id": {
4406
+ "name": "stage-id",
4571
4407
  "required": true,
4572
- "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
4408
+ "summary": "ID of the pipeline stage.",
4573
4409
  "hasDynamicHelp": false,
4574
4410
  "multiple": false,
4575
4411
  "type": "option"
4576
4412
  },
4577
- "next-stage-id": {
4578
- "name": "next-stage-id",
4413
+ "environment-name": {
4414
+ "char": "e",
4415
+ "name": "environment-name",
4579
4416
  "required": true,
4580
- "summary": "ID of the stage that follows the new stage in the pipeline.",
4417
+ "summary": "Name of the environment.",
4418
+ "hasDynamicHelp": false,
4419
+ "multiple": false,
4420
+ "type": "option"
4421
+ },
4422
+ "org-type": {
4423
+ "name": "org-type",
4424
+ "required": true,
4425
+ "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
4581
4426
  "hasDynamicHelp": false,
4582
4427
  "multiple": false,
4428
+ "options": [
4429
+ "Production",
4430
+ "Sandbox"
4431
+ ],
4583
4432
  "type": "option"
4433
+ },
4434
+ "no-browser": {
4435
+ "name": "no-browser",
4436
+ "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
4437
+ "allowNo": false,
4438
+ "type": "boolean"
4439
+ },
4440
+ "force": {
4441
+ "name": "force",
4442
+ "summary": "Replace the stage's existing environment. By default, the command blocks if the stage already has an environment to avoid orphaning it. With this flag, the new environment is added first and the previous one is removed only after the new environment is associated successfully.",
4443
+ "allowNo": false,
4444
+ "type": "boolean"
4584
4445
  }
4585
4446
  },
4586
4447
  "hasDynamicHelp": true,
4587
4448
  "hiddenAliases": [],
4588
- "id": "devops:pipeline:stage:add",
4449
+ "id": "devops:stage:environment:add",
4589
4450
  "pluginAlias": "@salesforce/plugin-devops-center",
4590
4451
  "pluginName": "@salesforce/plugin-devops-center",
4591
4452
  "pluginType": "jit",
4592
4453
  "strict": true,
4593
- "summary": "Add a stage to a DevOps Center pipeline.",
4454
+ "summary": "Add a Salesforce environment to a pipeline stage.",
4594
4455
  "enableJsonFlag": true,
4595
4456
  "isESM": true,
4596
4457
  "relativePath": [
4597
4458
  "lib",
4598
4459
  "commands",
4599
4460
  "devops",
4600
- "pipeline",
4601
4461
  "stage",
4462
+ "environment",
4602
4463
  "add.js"
4603
4464
  ]
4604
4465
  },
4605
- "devops:pipeline:stage:delete": {
4466
+ "devops:stage:environment:delete": {
4606
4467
  "aliases": [],
4607
4468
  "args": {},
4608
- "description": "Deletes the specified stage from the pipeline. If the stage sits between two other stages, the predecessor stage is automatically re-linked to the successor so the pipeline chain stays intact.",
4469
+ "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
4609
4470
  "examples": [
4610
- "Delete a stage from a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000002"
4471
+ "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
4611
4472
  ],
4612
4473
  "flags": {
4613
4474
  "json": {
@@ -4645,15 +4506,16 @@
4645
4506
  "pipeline-id": {
4646
4507
  "name": "pipeline-id",
4647
4508
  "required": true,
4648
- "summary": "ID of the pipeline that contains the stage.",
4509
+ "summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
4649
4510
  "hasDynamicHelp": false,
4650
4511
  "multiple": false,
4651
4512
  "type": "option"
4652
4513
  },
4653
- "stage-id": {
4654
- "name": "stage-id",
4514
+ "environment-id": {
4515
+ "char": "e",
4516
+ "name": "environment-id",
4655
4517
  "required": true,
4656
- "summary": "ID of the stage to delete.",
4518
+ "summary": "ID of the environment to delete.",
4657
4519
  "hasDynamicHelp": false,
4658
4520
  "multiple": false,
4659
4521
  "type": "option"
@@ -4661,29 +4523,30 @@
4661
4523
  },
4662
4524
  "hasDynamicHelp": true,
4663
4525
  "hiddenAliases": [],
4664
- "id": "devops:pipeline:stage:delete",
4526
+ "id": "devops:stage:environment:delete",
4665
4527
  "pluginAlias": "@salesforce/plugin-devops-center",
4666
4528
  "pluginName": "@salesforce/plugin-devops-center",
4667
4529
  "pluginType": "jit",
4668
4530
  "strict": true,
4669
- "summary": "Delete a stage from a DevOps Center pipeline.",
4531
+ "summary": "Delete an environment from a DevOps Center pipeline stage.",
4670
4532
  "enableJsonFlag": true,
4671
4533
  "isESM": true,
4672
4534
  "relativePath": [
4673
4535
  "lib",
4674
4536
  "commands",
4675
4537
  "devops",
4676
- "pipeline",
4677
4538
  "stage",
4539
+ "environment",
4678
4540
  "delete.js"
4679
4541
  ]
4680
4542
  },
4681
- "devops:pipeline:stage:update": {
4543
+ "project:deploy:pipeline:quick": {
4682
4544
  "aliases": [],
4683
4545
  "args": {},
4684
- "description": "Updates the name of a pipeline stage.",
4546
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, create a validated deployment with the \"project deploy pipeline validate\" command, which returns a job ID. Validated deployments haven't been deployed to the org yet; you deploy them with this command. Either pass the job ID to this command or use the --use-most-recent flag to use the job ID of the most recently validated deployment. For the quick deploy to succeed, the associated validated deployment must also have succeeded.\n\nExecuting this quick deploy command takes less time than a standard deploy because it skips running Apex tests. These tests were previously run as part of the validation. Validating first and then running a quick deploy is useful if the deployment to your production org take several hours and you don’t want to risk a failed deploy.\n\nThis command doesn't support source-tracking. The source you deploy overwrites the corresponding metadata in your org. This command doesn’t attempt to merge your source with the versions in your org.",
4685
4547
  "examples": [
4686
- "Rename a pipeline stage.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QV000000000001 --name \"Integration\""
4548
+ "Run a quick deploy using your default Devops Center org and a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
4549
+ "Asynchronously run a quick deploy of the most recently validated deployment using an org with alias \"my-prod-org\":\n<%= config.bin %> <%= command.id %> --async --use-most-recent --devops-center-username my-prod-org"
4687
4550
  ],
4688
4551
  "flags": {
4689
4552
  "json": {
@@ -4701,68 +4564,96 @@
4701
4564
  "multiple": false,
4702
4565
  "type": "option"
4703
4566
  },
4704
- "target-org": {
4705
- "char": "o",
4706
- "name": "target-org",
4707
- "noCacheDefault": true,
4708
- "required": true,
4709
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
4710
- "hasDynamicHelp": true,
4711
- "multiple": false,
4712
- "type": "option"
4567
+ "async": {
4568
+ "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
4569
+ "name": "async",
4570
+ "summary": "Run the command asynchronously.",
4571
+ "allowNo": false,
4572
+ "type": "boolean"
4713
4573
  },
4714
- "api-version": {
4715
- "description": "Override the api version used for api requests made by this command",
4716
- "name": "api-version",
4717
- "hasDynamicHelp": false,
4574
+ "concise": {
4575
+ "exclusive": [
4576
+ "verbose"
4577
+ ],
4578
+ "name": "concise",
4579
+ "summary": "Show concise output of the command result.",
4580
+ "allowNo": false,
4581
+ "type": "boolean"
4582
+ },
4583
+ "verbose": {
4584
+ "name": "verbose",
4585
+ "summary": "Show verbose output of the command result.",
4586
+ "allowNo": false,
4587
+ "type": "boolean"
4588
+ },
4589
+ "wait": {
4590
+ "char": "w",
4591
+ "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
4592
+ "exclusive": [
4593
+ "async"
4594
+ ],
4595
+ "name": "wait",
4596
+ "summary": "Number of minutes to wait for command to complete and display results.",
4597
+ "default": "33 minutes",
4598
+ "hasDynamicHelp": true,
4599
+ "helpValue": "<minutes>",
4718
4600
  "multiple": false,
4719
4601
  "type": "option"
4720
4602
  },
4721
- "stage-id": {
4722
- "char": "s",
4723
- "name": "stage-id",
4603
+ "devops-center-username": {
4604
+ "char": "c",
4605
+ "name": "devops-center-username",
4724
4606
  "required": true,
4725
- "summary": "ID of the pipeline stage to update.",
4726
- "hasDynamicHelp": false,
4607
+ "summary": "Username or alias of the DevOps Center org.",
4608
+ "hasDynamicHelp": true,
4727
4609
  "multiple": false,
4728
4610
  "type": "option"
4729
4611
  },
4730
- "name": {
4731
- "char": "n",
4732
- "name": "name",
4733
- "required": true,
4734
- "summary": "New name for the pipeline stage.",
4612
+ "job-id": {
4613
+ "char": "i",
4614
+ "description": "The job ID is valid for 10 days from when you started the validation.",
4615
+ "name": "job-id",
4616
+ "summary": "Job ID of the validated deployment to quick deploy.",
4735
4617
  "hasDynamicHelp": false,
4736
4618
  "multiple": false,
4737
4619
  "type": "option"
4620
+ },
4621
+ "use-most-recent": {
4622
+ "char": "r",
4623
+ "description": "For performance reasons, this flag uses only job IDs that were validated in the past 3 days or less. If your most recent deployment validation was more than 3 days ago, this flag won't find the job ID.",
4624
+ "name": "use-most-recent",
4625
+ "summary": "Use the job ID of the most recently validated deployment.",
4626
+ "allowNo": false,
4627
+ "type": "boolean"
4738
4628
  }
4739
4629
  },
4740
4630
  "hasDynamicHelp": true,
4741
4631
  "hiddenAliases": [],
4742
- "id": "devops:pipeline:stage:update",
4632
+ "id": "project:deploy:pipeline:quick",
4743
4633
  "pluginAlias": "@salesforce/plugin-devops-center",
4744
4634
  "pluginName": "@salesforce/plugin-devops-center",
4745
4635
  "pluginType": "jit",
4636
+ "state": "beta",
4746
4637
  "strict": true,
4747
- "summary": "Update a DevOps Center pipeline stage.",
4638
+ "summary": "Quickly deploy a validated deployment to an org.",
4748
4639
  "enableJsonFlag": true,
4749
4640
  "isESM": true,
4750
4641
  "relativePath": [
4751
4642
  "lib",
4752
4643
  "commands",
4753
- "devops",
4644
+ "project",
4645
+ "deploy",
4754
4646
  "pipeline",
4755
- "stage",
4756
- "update.js"
4647
+ "quick.js"
4757
4648
  ]
4758
4649
  },
4759
- "devops:stage:branch:add": {
4650
+ "project:deploy:pipeline:report": {
4760
4651
  "aliases": [],
4761
4652
  "args": {},
4762
- "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. If the stage already has a branch, the command blocks so the existing branch isn't orphaned; pass --force to replace it.",
4653
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nRun this command by either indicating a job ID or specifying the —use-most-recent flag to use the job ID of the most recent deploy operation.",
4763
4654
  "examples": [
4764
- "Add an existing branch to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main",
4765
- "Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
4655
+ "Check the status using a job ID:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --job-id 0Af0x000017yLUFCA2",
4656
+ "Check the status of the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --use-most-recent"
4766
4657
  ],
4767
4658
  "flags": {
4768
4659
  "json": {
@@ -4780,86 +4671,60 @@
4780
4671
  "multiple": false,
4781
4672
  "type": "option"
4782
4673
  },
4783
- "target-org": {
4784
- "char": "o",
4785
- "name": "target-org",
4786
- "noCacheDefault": true,
4674
+ "devops-center-username": {
4675
+ "char": "c",
4676
+ "name": "devops-center-username",
4787
4677
  "required": true,
4788
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
4678
+ "summary": "Username or alias of the DevOps Center org.",
4789
4679
  "hasDynamicHelp": true,
4790
4680
  "multiple": false,
4791
4681
  "type": "option"
4792
4682
  },
4793
- "api-version": {
4794
- "description": "Override the api version used for api requests made by this command",
4795
- "name": "api-version",
4796
- "hasDynamicHelp": false,
4797
- "multiple": false,
4798
- "type": "option"
4799
- },
4800
- "pipeline-id": {
4801
- "name": "pipeline-id",
4802
- "required": true,
4803
- "summary": "ID of the pipeline that contains the stage.",
4804
- "hasDynamicHelp": false,
4805
- "multiple": false,
4806
- "type": "option"
4807
- },
4808
- "stage-id": {
4809
- "name": "stage-id",
4810
- "required": true,
4811
- "summary": "ID of the pipeline stage to associate the branch with.",
4812
- "hasDynamicHelp": false,
4813
- "multiple": false,
4814
- "type": "option"
4815
- },
4816
- "branch-name": {
4817
- "char": "b",
4818
- "name": "branch-name",
4819
- "required": true,
4820
- "summary": "Name of the repository branch to assign to the stage.",
4683
+ "job-id": {
4684
+ "char": "i",
4685
+ "description": "The job ID is valid for 10 days from when you started the deploy operation.",
4686
+ "name": "job-id",
4687
+ "summary": "Job ID of the pipeline deployment to check the status of.",
4821
4688
  "hasDynamicHelp": false,
4822
4689
  "multiple": false,
4823
4690
  "type": "option"
4824
4691
  },
4825
- "create-vcs-branch": {
4826
- "name": "create-vcs-branch",
4827
- "summary": "Create the branch in the remote repository if it doesn't already exist.",
4828
- "allowNo": false,
4829
- "type": "boolean"
4830
- },
4831
- "force": {
4832
- "name": "force",
4833
- "summary": "Replace the stage's existing branch. By default, the command blocks if the stage already has a branch to avoid orphaning it. With this flag, the new branch is associated and the previous branch record is removed if no other stage references it.",
4692
+ "use-most-recent": {
4693
+ "char": "r",
4694
+ "description": "For performance reasons, this flag uses job IDs for deploy operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find the job ID.",
4695
+ "name": "use-most-recent",
4696
+ "summary": "Use the job ID of the most recent deploy operation.",
4834
4697
  "allowNo": false,
4835
4698
  "type": "boolean"
4836
4699
  }
4837
4700
  },
4838
4701
  "hasDynamicHelp": true,
4839
4702
  "hiddenAliases": [],
4840
- "id": "devops:stage:branch:add",
4703
+ "id": "project:deploy:pipeline:report",
4841
4704
  "pluginAlias": "@salesforce/plugin-devops-center",
4842
4705
  "pluginName": "@salesforce/plugin-devops-center",
4843
4706
  "pluginType": "jit",
4707
+ "state": "beta",
4844
4708
  "strict": true,
4845
- "summary": "Add a source code repository branch to a pipeline stage.",
4709
+ "summary": "Check the status of a pipeline deploy operation.",
4846
4710
  "enableJsonFlag": true,
4847
4711
  "isESM": true,
4848
4712
  "relativePath": [
4849
4713
  "lib",
4850
4714
  "commands",
4851
- "devops",
4852
- "stage",
4853
- "branch",
4854
- "add.js"
4715
+ "project",
4716
+ "deploy",
4717
+ "pipeline",
4718
+ "report.js"
4855
4719
  ]
4856
4720
  },
4857
- "devops:stage:branch:delete": {
4721
+ "project:deploy:pipeline:resume": {
4858
4722
  "aliases": [],
4859
4723
  "args": {},
4860
- "description": "Removes the branch linked to the specified pipeline stage. Because branches are configured from right to left (a stage can have a branch only after the stage to its right does), removing a branch also removes the branches from all upstream stages (to the left) in the pipeline, keeping it in a valid state. The branch records in the repository are not deleted; only their association with the stages is removed. The stage must belong to an inactive pipeline.",
4724
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command. \n\nUse this command to resume watching a pipeline deploy operation if the original command times out or you specified the --async flag.\n\nRun this command by either indicating a job ID or specifying the --use-most-recent flag to use the job ID of the most recent deploy operation.",
4861
4725
  "examples": [
4862
- "Delete the branch associated with a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001"
4726
+ "Resume watching a deploy operation using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
4727
+ "Resume watching the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --use-most-recent"
4863
4728
  ],
4864
4729
  "flags": {
4865
4730
  "json": {
@@ -4877,65 +4742,89 @@
4877
4742
  "multiple": false,
4878
4743
  "type": "option"
4879
4744
  },
4880
- "target-org": {
4881
- "char": "o",
4882
- "name": "target-org",
4883
- "noCacheDefault": true,
4745
+ "devops-center-username": {
4746
+ "char": "c",
4747
+ "name": "devops-center-username",
4884
4748
  "required": true,
4885
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
4749
+ "summary": "Username or alias of the DevOps Center org.",
4886
4750
  "hasDynamicHelp": true,
4887
4751
  "multiple": false,
4888
4752
  "type": "option"
4889
4753
  },
4890
- "api-version": {
4891
- "description": "Override the api version used for api requests made by this command",
4892
- "name": "api-version",
4754
+ "job-id": {
4755
+ "char": "i",
4756
+ "description": "These commands return a job ID if they time out or you specified the --async flag:\n\n- sf project deploy pipeline start\n- sf project deploy pipeline validate\n- sf project deploy pipeline quick\n\nThe job ID is valid for 10 days from when you started the deploy operation.",
4757
+ "name": "job-id",
4758
+ "summary": "Job ID of the pipeline deploy operation you want to resume.",
4893
4759
  "hasDynamicHelp": false,
4894
4760
  "multiple": false,
4895
4761
  "type": "option"
4896
4762
  },
4897
- "pipeline-id": {
4898
- "name": "pipeline-id",
4899
- "required": true,
4900
- "summary": "ID of the pipeline that contains the stage. Used to verify the pipeline is inactive before deleting.",
4901
- "hasDynamicHelp": false,
4902
- "multiple": false,
4903
- "type": "option"
4763
+ "use-most-recent": {
4764
+ "char": "r",
4765
+ "description": "For performance reasons, this flag uses job IDs for operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find a job ID.",
4766
+ "name": "use-most-recent",
4767
+ "summary": "Use the job ID of the most recent deploy operation.",
4768
+ "allowNo": false,
4769
+ "type": "boolean"
4904
4770
  },
4905
- "stage-id": {
4906
- "name": "stage-id",
4907
- "required": true,
4908
- "summary": "ID of the pipeline stage whose branch you want to delete.",
4909
- "hasDynamicHelp": false,
4771
+ "concise": {
4772
+ "exclusive": [
4773
+ "verbose"
4774
+ ],
4775
+ "name": "concise",
4776
+ "summary": "Show concise output of the command result.",
4777
+ "allowNo": false,
4778
+ "type": "boolean"
4779
+ },
4780
+ "verbose": {
4781
+ "name": "verbose",
4782
+ "summary": "Show verbose output of the command result.",
4783
+ "allowNo": false,
4784
+ "type": "boolean"
4785
+ },
4786
+ "wait": {
4787
+ "char": "w",
4788
+ "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
4789
+ "exclusive": [
4790
+ "async"
4791
+ ],
4792
+ "name": "wait",
4793
+ "summary": "Number of minutes to wait for command to complete and display results.",
4794
+ "default": "33 minutes",
4795
+ "hasDynamicHelp": true,
4796
+ "helpValue": "<minutes>",
4910
4797
  "multiple": false,
4911
4798
  "type": "option"
4912
4799
  }
4913
4800
  },
4914
4801
  "hasDynamicHelp": true,
4915
4802
  "hiddenAliases": [],
4916
- "id": "devops:stage:branch:delete",
4803
+ "id": "project:deploy:pipeline:resume",
4917
4804
  "pluginAlias": "@salesforce/plugin-devops-center",
4918
4805
  "pluginName": "@salesforce/plugin-devops-center",
4919
4806
  "pluginType": "jit",
4807
+ "state": "beta",
4920
4808
  "strict": true,
4921
- "summary": "Delete the source code repository branch associated with a pipeline stage.",
4809
+ "summary": "Resume watching a pipeline deploy operation.",
4922
4810
  "enableJsonFlag": true,
4923
4811
  "isESM": true,
4924
4812
  "relativePath": [
4925
4813
  "lib",
4926
4814
  "commands",
4927
- "devops",
4928
- "stage",
4929
- "branch",
4930
- "delete.js"
4815
+ "project",
4816
+ "deploy",
4817
+ "pipeline",
4818
+ "resume.js"
4931
4819
  ]
4932
4820
  },
4933
- "devops:stage:environment:add": {
4821
+ "project:deploy:pipeline:start": {
4934
4822
  "aliases": [],
4935
4823
  "args": {},
4936
- "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
4824
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, changes in the pipeline stage's branch must be merged in the source control repository.",
4937
4825
  "examples": [
4938
- "Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
4826
+ "Deploy changes in the Staging branch to the Staging environment (sandbox), if the previous stage is the bundling stage:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox --bundle-version-name 1.0",
4827
+ "Deploy all changes in the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
4939
4828
  ],
4940
4829
  "flags": {
4941
4830
  "json": {
@@ -4953,98 +4842,138 @@
4953
4842
  "multiple": false,
4954
4843
  "type": "option"
4955
4844
  },
4956
- "target-org": {
4957
- "char": "o",
4958
- "name": "target-org",
4959
- "noCacheDefault": true,
4845
+ "branch-name": {
4846
+ "char": "b",
4847
+ "name": "branch-name",
4960
4848
  "required": true,
4961
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
4962
- "hasDynamicHelp": true,
4849
+ "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
4850
+ "hasDynamicHelp": false,
4963
4851
  "multiple": false,
4964
4852
  "type": "option"
4965
4853
  },
4966
- "api-version": {
4967
- "description": "Override the api version used for api requests made by this command",
4968
- "name": "api-version",
4854
+ "bundle-version-name": {
4855
+ "char": "v",
4856
+ "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
4857
+ "name": "bundle-version-name",
4858
+ "summary": "Version name of the bundle.",
4969
4859
  "hasDynamicHelp": false,
4970
4860
  "multiple": false,
4971
4861
  "type": "option"
4972
4862
  },
4973
- "pipeline-id": {
4974
- "name": "pipeline-id",
4863
+ "deploy-all": {
4864
+ "char": "a",
4865
+ "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
4866
+ "name": "deploy-all",
4867
+ "summary": "Deploy all metadata in the branch to the stage's org.",
4868
+ "allowNo": false,
4869
+ "type": "boolean"
4870
+ },
4871
+ "devops-center-project-name": {
4872
+ "char": "p",
4873
+ "name": "devops-center-project-name",
4975
4874
  "required": true,
4976
- "summary": "ID of the pipeline that contains the stage.",
4875
+ "summary": "Name of the DevOps Center project.",
4977
4876
  "hasDynamicHelp": false,
4978
4877
  "multiple": false,
4979
4878
  "type": "option"
4980
4879
  },
4981
- "stage-id": {
4982
- "name": "stage-id",
4880
+ "devops-center-username": {
4881
+ "char": "c",
4882
+ "name": "devops-center-username",
4983
4883
  "required": true,
4984
- "summary": "ID of the pipeline stage.",
4985
- "hasDynamicHelp": false,
4884
+ "summary": "Username or alias of the DevOps Center org.",
4885
+ "hasDynamicHelp": true,
4986
4886
  "multiple": false,
4987
4887
  "type": "option"
4988
4888
  },
4989
- "environment-name": {
4990
- "char": "e",
4991
- "name": "environment-name",
4992
- "required": true,
4993
- "summary": "Name of the environment.",
4889
+ "tests": {
4890
+ "char": "t",
4891
+ "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
4892
+ "name": "tests",
4893
+ "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
4994
4894
  "hasDynamicHelp": false,
4995
- "multiple": false,
4895
+ "multiple": true,
4996
4896
  "type": "option"
4997
4897
  },
4998
- "org-type": {
4999
- "name": "org-type",
5000
- "required": true,
5001
- "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
4898
+ "test-level": {
4899
+ "char": "l",
4900
+ "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
4901
+ "name": "test-level",
4902
+ "summary": "Deployment Apex testing level.",
5002
4903
  "hasDynamicHelp": false,
5003
4904
  "multiple": false,
5004
4905
  "options": [
5005
- "Production",
5006
- "Sandbox"
4906
+ "NoTestRun",
4907
+ "RunSpecifiedTests",
4908
+ "RunLocalTests",
4909
+ "RunAllTestsInOrg"
5007
4910
  ],
5008
4911
  "type": "option"
5009
4912
  },
5010
- "no-browser": {
5011
- "name": "no-browser",
5012
- "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
4913
+ "async": {
4914
+ "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
4915
+ "name": "async",
4916
+ "summary": "Run the command asynchronously.",
5013
4917
  "allowNo": false,
5014
4918
  "type": "boolean"
5015
4919
  },
5016
- "force": {
5017
- "name": "force",
5018
- "summary": "Replace the stage's existing environment. By default, the command blocks if the stage already has an environment to avoid orphaning it. With this flag, the new environment is added first and the previous one is removed only after the new environment is associated successfully.",
4920
+ "wait": {
4921
+ "char": "w",
4922
+ "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
4923
+ "exclusive": [
4924
+ "async"
4925
+ ],
4926
+ "name": "wait",
4927
+ "summary": "Number of minutes to wait for command to complete and display results.",
4928
+ "default": "33 minutes",
4929
+ "hasDynamicHelp": true,
4930
+ "helpValue": "<minutes>",
4931
+ "multiple": false,
4932
+ "type": "option"
4933
+ },
4934
+ "verbose": {
4935
+ "name": "verbose",
4936
+ "summary": "Show verbose output of the command result.",
4937
+ "allowNo": false,
4938
+ "type": "boolean"
4939
+ },
4940
+ "concise": {
4941
+ "exclusive": [
4942
+ "verbose"
4943
+ ],
4944
+ "name": "concise",
4945
+ "summary": "Show concise output of the command result.",
5019
4946
  "allowNo": false,
5020
4947
  "type": "boolean"
5021
4948
  }
5022
4949
  },
5023
4950
  "hasDynamicHelp": true,
5024
4951
  "hiddenAliases": [],
5025
- "id": "devops:stage:environment:add",
4952
+ "id": "project:deploy:pipeline:start",
5026
4953
  "pluginAlias": "@salesforce/plugin-devops-center",
5027
4954
  "pluginName": "@salesforce/plugin-devops-center",
5028
4955
  "pluginType": "jit",
4956
+ "state": "beta",
5029
4957
  "strict": true,
5030
- "summary": "Add a Salesforce environment to a pipeline stage.",
4958
+ "summary": "Deploy changes from a branch to the pipeline stage’s org.",
5031
4959
  "enableJsonFlag": true,
5032
4960
  "isESM": true,
5033
4961
  "relativePath": [
5034
4962
  "lib",
5035
4963
  "commands",
5036
- "devops",
5037
- "stage",
5038
- "environment",
5039
- "add.js"
4964
+ "project",
4965
+ "deploy",
4966
+ "pipeline",
4967
+ "start.js"
5040
4968
  ]
5041
4969
  },
5042
- "devops:stage:environment:delete": {
4970
+ "project:deploy:pipeline:validate": {
5043
4971
  "aliases": [],
5044
4972
  "args": {},
5045
- "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
4973
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nA validation runs Apex tests to verify whether a deployment will succeed without actually deploying the metadata to your environment, so you can then quickly deploy the changes later without re-running the tests.",
5046
4974
  "examples": [
5047
- "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
4975
+ "Perform a validate-only deployment from the Staging branch to the Staging environment (sandbox):\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox",
4976
+ "Perform a validate-only deployment of all changes from the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
5048
4977
  ],
5049
4978
  "flags": {
5050
4979
  "json": {
@@ -5062,58 +4991,129 @@
5062
4991
  "multiple": false,
5063
4992
  "type": "option"
5064
4993
  },
5065
- "target-org": {
5066
- "char": "o",
5067
- "name": "target-org",
5068
- "noCacheDefault": true,
4994
+ "branch-name": {
4995
+ "char": "b",
4996
+ "name": "branch-name",
5069
4997
  "required": true,
5070
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
5071
- "hasDynamicHelp": true,
4998
+ "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
4999
+ "hasDynamicHelp": false,
5072
5000
  "multiple": false,
5073
5001
  "type": "option"
5074
5002
  },
5075
- "api-version": {
5076
- "description": "Override the api version used for api requests made by this command",
5077
- "name": "api-version",
5003
+ "bundle-version-name": {
5004
+ "char": "v",
5005
+ "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
5006
+ "name": "bundle-version-name",
5007
+ "summary": "Version name of the bundle.",
5078
5008
  "hasDynamicHelp": false,
5079
5009
  "multiple": false,
5080
5010
  "type": "option"
5081
5011
  },
5082
- "pipeline-id": {
5083
- "name": "pipeline-id",
5012
+ "deploy-all": {
5013
+ "char": "a",
5014
+ "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
5015
+ "name": "deploy-all",
5016
+ "summary": "Deploy all metadata in the branch to the stage's org.",
5017
+ "allowNo": false,
5018
+ "type": "boolean"
5019
+ },
5020
+ "devops-center-project-name": {
5021
+ "char": "p",
5022
+ "name": "devops-center-project-name",
5084
5023
  "required": true,
5085
- "summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
5024
+ "summary": "Name of the DevOps Center project.",
5086
5025
  "hasDynamicHelp": false,
5087
5026
  "multiple": false,
5088
5027
  "type": "option"
5089
5028
  },
5090
- "environment-id": {
5091
- "char": "e",
5092
- "name": "environment-id",
5029
+ "devops-center-username": {
5030
+ "char": "c",
5031
+ "name": "devops-center-username",
5093
5032
  "required": true,
5094
- "summary": "ID of the environment to delete.",
5033
+ "summary": "Username or alias of the DevOps Center org.",
5034
+ "hasDynamicHelp": true,
5035
+ "multiple": false,
5036
+ "type": "option"
5037
+ },
5038
+ "tests": {
5039
+ "char": "t",
5040
+ "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
5041
+ "name": "tests",
5042
+ "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
5043
+ "hasDynamicHelp": false,
5044
+ "multiple": true,
5045
+ "type": "option"
5046
+ },
5047
+ "test-level": {
5048
+ "char": "l",
5049
+ "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
5050
+ "name": "test-level",
5051
+ "summary": "Deployment Apex testing level.",
5095
5052
  "hasDynamicHelp": false,
5096
5053
  "multiple": false,
5054
+ "options": [
5055
+ "NoTestRun",
5056
+ "RunSpecifiedTests",
5057
+ "RunLocalTests",
5058
+ "RunAllTestsInOrg"
5059
+ ],
5060
+ "type": "option"
5061
+ },
5062
+ "async": {
5063
+ "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
5064
+ "name": "async",
5065
+ "summary": "Run the command asynchronously.",
5066
+ "allowNo": false,
5067
+ "type": "boolean"
5068
+ },
5069
+ "wait": {
5070
+ "char": "w",
5071
+ "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
5072
+ "exclusive": [
5073
+ "async"
5074
+ ],
5075
+ "name": "wait",
5076
+ "summary": "Number of minutes to wait for command to complete and display results.",
5077
+ "default": "33 minutes",
5078
+ "hasDynamicHelp": true,
5079
+ "helpValue": "<minutes>",
5080
+ "multiple": false,
5097
5081
  "type": "option"
5082
+ },
5083
+ "verbose": {
5084
+ "name": "verbose",
5085
+ "summary": "Show verbose output of the command result.",
5086
+ "allowNo": false,
5087
+ "type": "boolean"
5088
+ },
5089
+ "concise": {
5090
+ "exclusive": [
5091
+ "verbose"
5092
+ ],
5093
+ "name": "concise",
5094
+ "summary": "Show concise output of the command result.",
5095
+ "allowNo": false,
5096
+ "type": "boolean"
5098
5097
  }
5099
5098
  },
5100
5099
  "hasDynamicHelp": true,
5101
5100
  "hiddenAliases": [],
5102
- "id": "devops:stage:environment:delete",
5101
+ "id": "project:deploy:pipeline:validate",
5103
5102
  "pluginAlias": "@salesforce/plugin-devops-center",
5104
5103
  "pluginName": "@salesforce/plugin-devops-center",
5105
5104
  "pluginType": "jit",
5105
+ "state": "beta",
5106
5106
  "strict": true,
5107
- "summary": "Delete an environment from a DevOps Center pipeline stage.",
5107
+ "summary": "Perform a validate-only deployment from a branch to the pipeline stage’s org.",
5108
5108
  "enableJsonFlag": true,
5109
5109
  "isESM": true,
5110
5110
  "relativePath": [
5111
5111
  "lib",
5112
5112
  "commands",
5113
- "devops",
5114
- "stage",
5115
- "environment",
5116
- "delete.js"
5113
+ "project",
5114
+ "deploy",
5115
+ "pipeline",
5116
+ "validate.js"
5117
5117
  ]
5118
5118
  },
5119
5119
  "flow:get:log": {
@@ -7024,5 +7024,5 @@
7024
7024
  "requiresProject": true
7025
7025
  }
7026
7026
  },
7027
- "version": "2.156.7"
7027
+ "version": "2.157.2"
7028
7028
  }