@ibm-cloud/cd-tools 1.11.2 → 1.11.4

package/README.md

@@ -106,7 +106,7 @@ The `copy-toolchain` command copies a [toolchain](https://cloud.ibm.com/docs/Con
 7. Git Repos and Issue Tracking tool integrations that use Personal Access Tokens (PATs) for authentication will automatically be converted to use OAuth. You can re-configure the tool integrations after copying to use a PAT again.
 
 ### Prerequisites
-- An [IBM Cloud API key](https://cloud.ibm.com/docs/account?topic=account-manapikey) with the IAM access listed below.
+- An [IBM Cloud API key](https://cloud.ibm.com/docs/account?topic=account-manapikey) with the IAM access listed below. The API key must be user API key. Service ID API keys are not supported.
 - **Viewer** access for the source Toolchain(s) being copied
 - **Editor** access for creating new Toolchains in the target region
 - **Administrator** access for other IBM Cloud service instances that have a tool integration with IAM service-to-service authorizations, such as [Secrets Manager](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-getting-started), [Event Notifications](https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-getting-started), etc.
@@ -143,12 +143,12 @@ Examples:
       Copy a toolchain to the Frankfurt region with the specified name and target resource group, using the given API key
 
 Environment Variables:
-  IBMCLOUD_API_KEY                       API key used to authenticate. Must have IAM permission to read and create toolchains and service-to-service authorizations in source and target region / resource group
+  IBMCLOUD_API_KEY                       API key used to authenticate. Must be a user API key, with IAM permission to read and create toolchains and service-to-service authorizations in source and target region / resource group
 
 Basic options:
   -c, --toolchain-crn <crn>              The CRN of the source toolchain to copy
   -r, --region <region>                  The destination region of the copied toolchain (choices: "au-syd", "br-sao", "ca-mon", "ca-tor", "eu-de", "eu-es", "eu-gb", "jp-osa", "jp-tok", "us-east", "us-south")
-  -a, --apikey <api_key>                 API key used to authenticate. Must have IAM permission to read and create toolchains and service-to-service authorizations in source and target region / resource group
+  -a, --apikey <api_key>                 API key used to authenticate. Must be a user API key, with IAM permission to read and create toolchains and service-to-service authorizations in source and target region / resource group
   -n, --name <name>                      (Optional) The name of the copied toolchain (default: same name as original)
   -g, --resource-group <resource_group>  (Optional) The name or ID of destination resource group of the copied toolchain (default: same resource group as original)
   -t, --tag <tag>                        (Optional) The tag to add to the copied toolchain

package/cmd/copy-toolchain.js

@@ -50,7 +50,7 @@ const command = new Command('copy-toolchain')
 			.choices(TARGET_REGIONS)
 			.makeOptionMandatory()
 	)
-	.option('-a, --apikey <api_key>', 'API key used to authenticate. Must have IAM permission to read and create toolchains and service-to-service authorizations in source and target region / resource group')
+	.option('-a, --apikey <api_key>', 'API key used to authenticate. Must be a user API key, with IAM permission to read and create toolchains and service-to-service authorizations in source and target region / resource group')
 	.option('-n, --name <name>', '(Optional) The name of the copied toolchain (default: same name as original)')
 	.option('-g, --resource-group <resource_group>', '(Optional) The name or ID of destination resource group of the copied toolchain (default: same resource group as original)')
 	.option('-t, --tag <tag>', '(Optional) The tag to add to the copied toolchain')

package/cmd/direct-transfer.js

@@ -505,7 +505,21 @@ async function directTransfer(options) {
 
   try {
     console.log(`Fetching source group from ID: ${options.groupId}...`);
-    const sourceGroup = await source.getGroup(options.groupId);
+    let sourceGroup;
+    try {
+      sourceGroup = await source.getGroup(options.groupId);
+    } catch (err) {
+      if (err?.response?.status === 404) {
+        console.error(
+          `Error: group "${options.groupId}" not found in source region "${options.sourceRegion}".\n` +
+          `Tip: -g accepts numeric ID or full group path like "parent/subgroup".`
+        );
+        return 1;
+      }
+
+      console.error(`Error: failed to fetch group "${options.groupId}": ${err?.message || err}`);
+      return 1;
+    }
 
     let destinationGroupPath = options.newGroupSlug || sourceGroup.path;
 

package/config.js

@@ -1,6 +1,6 @@
 /**
  * Licensed Materials - Property of IBM
- * (c) Copyright IBM Corporation 2025. All Rights Reserved.
+ * (c) Copyright IBM Corporation 2025, 2026. All Rights Reserved.
  *
  * Note to U.S. Government Users Restricted Rights:
  * Use, duplication or disclosure restricted by GSA ADP Schedule
@@ -17,7 +17,7 @@ Examples:
       Copy a toolchain to the Frankfurt region with the specified name and target resource group, using the given API key
 
 Environment Variables:
-  IBMCLOUD_API_KEY                       API key used to authenticate. Must have IAM permission to read and create toolchains and service-to-service authorizations in source and target region / resource group`;
+  IBMCLOUD_API_KEY                       API key used to authenticate. Must be a user API key, with IAM permission to read and create toolchains and service-to-service authorizations in source and target region / resource group`;
 
 const COPY_PROJECT_GROUP_DESC = `Copies all Git Repos and Issue Tracking projects in a group to another region.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibm-cloud/cd-tools",
-  "version": "1.11.2",
+  "version": "1.11.4",
   "description": "Tools and utilities for the IBM Cloud Continuous Delivery service and resources",
   "repository": {
     "type": "git",