feat: support sf/sfdx retrieve & deploy of recursively-foldered TagSet

src/collections/componentSet.ts

@@ -816,6 +816,10 @@ const constructFullName = (registry: RegistryAccess, type: MetadataType, fullNam
   // a "/" so the metadata API can identify it as a folder.
   ['DashboardFolder', 'ReportFolder', 'EmailTemplateFolder'].includes(type.name) && !fullName.endsWith('/')
     ? `${fullName}/`
+    : // TagSet nests recursively by parent-set identity. inFolder stores it on disk as A/B/C, but the
+    // metadata API contract for TagSet fullNames is dot-separated (A.B.C), so translate on the way out.
+    type.name === 'TagSet'
+    ? fullName.replace(/\//g, '.')
     : registry.getParentType(type.name)?.strategies?.recomposition === 'startEmpty' && fullName.includes('.')
     ? // they're reassembled like CustomLabels.MyLabel
       fullName.split('.')[1]

src/registry/metadataRegistry.json

@@ -604,7 +604,8 @@
     "cnfgItemTypeRelationDef": "cnfgitemtyperelationdef",
     "cnfgMgmtRelationTypeDef": "cnfgmgmtrelationtypedef",
     "meetingPlaybookDefinition": "meetingplaybookdefinition",
-    "idpConfiguration": "idpconfiguration"
+    "idpConfiguration": "idpconfiguration",
+    "tagSet": "tagset"
   },
   "types": {
     "accesscontrolpolicy": {
@@ -5394,6 +5395,15 @@
         "adapter": "bundle"
       },
       "supportsPartialDelete": true
+    },
+    "tagset": {
+      "id": "tagset",
+      "name": "TagSet",
+      "suffix": "tagSet",
+      "directoryName": "tagSet",
+      "inFolder": true,
+      "strictDirectoryName": false,
+      "supportsWildcardAndName": true
     }
   }
 }

test/collections/componentSet.test.ts

@@ -944,6 +944,20 @@ describe('ComponentSet', () => {
       ]);
     });
 
+    it('should translate a recursively-foldered TagSet path to a dot-separated member', async () => {
+      // On disk, nested tag sets are stored as folders (tagSet/A/B/C.tagSet), so the resolved
+      // fullName is slash-separated. The TagSet metadata API contract is dot-separated.
+      const member = { fullName: 'DataGovernanceTags/CustomTags__as/CustomTagsChild1__as', type: 'TagSet' };
+      const set = new ComponentSet([member], registryAccess);
+
+      expect((await set.getObject()).Package.types).to.deep.equal([
+        {
+          name: 'TagSet',
+          members: ['DataGovernanceTags.CustomTags__as.CustomTagsChild1__as'],
+        },
+      ]);
+    });
+
     it('should include required child types as defined in the registry', async () => {
       const set = new ComponentSet([MATCHING_RULES_COMPONENT]);
       expect((await set.getObject()).Package.types).to.deep.equal([