@salesforce/plugin-metadata-enrichment 0.0.1 → 0.0.3

package/README.md

@@ -67,14 +67,14 @@ sf plugins
 
 ## `sf metadata enrich`
 
-Enrich metadata
+Enrich metadata components in your DX project by adding AI-generated descriptions.
 
 ```
 USAGE
   $ sf metadata enrich -o <value> -m <value>... [--json] [--flags-dir <value>]
 
 FLAGS
-  -m, --metadata=<value>...  (required) (required) Metadata type and optional component name to enrich.
+  -m, --metadata=<value>...  (required) Metadata type and optional component name to enrich.
   -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                              configuration variable is already set.
 
@@ -83,40 +83,51 @@ GLOBAL FLAGS
   --json               Format output as json.
 
 DESCRIPTION
-  Enrich metadata for a Salesforce component.
+  Enrich metadata components in your DX project by adding AI-generated descriptions.
+
+  Use this command to add AI-generated descriptions right in the metadata source files in your local DX project. These
+  enriched descriptions succinctly outline the metadata component’s purpose and capabilities, which in turn provide
+  context when vibe coding with an AI tool, such as Agentforce Vibes.
 
-  You must run this command from within a project.
+  This command updates only the local metadata source files in your DX project; it doesn't change the components in your
+  org. If you want the AI-generated descriptions in your org, then you must explicitly deploy the updated metadata
+  components to your org by using, for example, the "project deploy start" CLI command.
 
-  Generate and store descriptions in metadata that provide additional context to the component’s functionality and
-  purpose.
+  To enrich multiple metadata components, specify multiple --metadata <name> flags. Enclose names that contain spaces in
+  double quotes.
 
-  To deploy multiple metadata components, either set multiple --metadata flags or a single --metadata flag with multiple
-  names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to
-  --source-dir.
+  Even though this command updates only local files in your DX project, you're still required to authorize and specify
+  an org, which is how the command accesses a large language model (LLM).
 
-  This is not saved in the org until you deploy the project.
+  Currently, this command supports enriching only Lightning Web Components, represented by the LightningComponentBundle
+  metadata type.
 
-  This plugin only supports enrichment for LightningComponentBundle metadata at the moment.
+  Your org must be eligible for metadata enrichment. Your Salesforce admin can help with that.
 
 EXAMPLES
-  Enrich metadata for a select LightningComponentBundle in the project
-  $ sf metadata enrich --metadata LightningComponentBundle:ComponentName
+  Enrich the "HelloWorld" LightningComponentBundle metadata component in the local DX project; use your default org:
+
+    $ sf metadata enrich --metadata LightningComponentBundle:HelloWorld
+
+  Enrich the "HelloWorld" LightningComponentBundle metadata component and use the org with alias "my-org":
 
-  Enrich metadata for a select LightningComponentBundle in the project for a specified target org
-  $ sf metadata enrich --metadata LightningComponentBundle:ComponentName --target-org OrgAlias
+    $ sf metadata enrich --metadata LightningComponentBundle:HelloWorld --target-org my-org
 
-  Enrich metadata for multiple LightningComponentBundle in the project
-  $ sf metadata enrich --metadata LightningComponentBundle:Component1 --metadata LightningComponentBundle:Component2
+  Enrich metadata for multiple LightningComponentBundles using your default org:
 
-  Enrich metadata for multiple LightningComponentBundle in the project matching wildcard
-  $ sf metadata enrich --metadata LightningComponentBundle:Component*
+    $ sf metadata enrich --metadata LightningComponentBundle:Component1 --metadata \
+      LightningComponentBundle:Component2
+
+  Enrich metadata for multiple LightningComponentBundles using a matching wildcard:
+
+    $ sf metadata enrich --metadata "LightningComponentBundle:Component\*"
 
 FLAG DESCRIPTIONS
-  -m, --metadata=<value>...  (required) Metadata type and optional component name to enrich.
+  -m, --metadata=<value>...  Metadata type and optional component name to enrich.
 
-    Wildcards (* ) supported as long as you use quotes, such as "LightningComponentBundle:MyClass*"
+    Wildcards ("_") are supported as long as you use double quotes, such as "LightningComponentBundle:MyClass_".
 ```
 
-_See code: [src/commands/metadata/enrich.ts](https://github.com/salesforcecli/plugin-metadata-enrichment/blob/1.1.76/src/commands/metadata/enrich.ts)_
+_See code: [src/commands/metadata/enrich.ts](https://github.com/salesforcecli/plugin-metadata-enrichment/blob/0.0.3/src/commands/metadata/enrich.ts)_
 
 <!-- commandsstop -->

package/lib/commands/metadata/enrich.d.ts

@@ -4,6 +4,7 @@ export default class MetadataEnrich extends SfCommand<EnrichmentMetrics> {
     static readonly summary: string;
     static readonly description: string;
     static readonly examples: string[];
+    static readonly state = "preview";
     static readonly flags: {
         'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
         metadata: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;

package/lib/commands/metadata/enrich.js

@@ -13,20 +13,19 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { MultiStageOutput } from '@oclif/multi-stage-output';
 import { Messages, SfProject } from '@salesforce/core';
-import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Flags, SfCommand, Ux } from '@salesforce/sf-plugins-core';
 import { ComponentSetBuilder } from '@salesforce/source-deploy-retrieve';
-import { EnrichmentHandler, EnrichmentMetrics, EnrichmentStatus, FileProcessor } from '@salesforce/metadata-enrichment';
-import { ComponentProcessor } from '../../component/index.js';
-import { MetricsFormatter, EnrichmentRecords } from '../../utils/index.js';
+import { ComponentProcessor, EnrichmentHandler, EnrichmentMetrics, EnrichmentRecords, EnrichmentStatus, FileProcessor } from '@salesforce/metadata-enrichment';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const commandMessages = Messages.loadMessages('@salesforce/plugin-metadata-enrichment', 'metadata.enrich');
-const errorsMessages = Messages.loadMessages('@salesforce/plugin-metadata-enrichment', 'errors');
 const metricsMessages = Messages.loadMessages('@salesforce/plugin-metadata-enrichment', 'metrics');
 export default class MetadataEnrich extends SfCommand {
     static summary = commandMessages.getMessage('summary');
     static description = commandMessages.getMessage('description');
     static examples = commandMessages.getMessages('examples');
+    static state = 'preview';
     static flags = {
         'target-org': Flags.requiredOrg(),
         metadata: Flags.string({
@@ -42,7 +41,17 @@ export default class MetadataEnrich extends SfCommand {
         const { flags } = await this.parse(MetadataEnrich);
         const org = flags['target-org'];
         const metadataEntries = flags['metadata'];
-        this.spinner.start(commandMessages.getMessage('spinner.setup'));
+        const STAGES_MSO = [
+            commandMessages.getMessage('stage.setup'),
+            commandMessages.getMessage('stage.executing'),
+            commandMessages.getMessage('stage.updating.files'),
+        ];
+        const mso = new MultiStageOutput({
+            stages: STAGES_MSO,
+            title: commandMessages.getMessage('summary'),
+            jsonEnabled: this.jsonEnabled(),
+        });
+        mso.goto(STAGES_MSO[0]);
         const projectComponentSet = await ComponentSetBuilder.build({
             metadata: {
                 metadataEntries,
@@ -50,7 +59,7 @@ export default class MetadataEnrich extends SfCommand {
             },
         });
         const projectSourceComponents = projectComponentSet.getSourceComponents().toArray();
-        const enrichmentRecords = new EnrichmentRecords(projectSourceComponents, errorsMessages);
+        const enrichmentRecords = new EnrichmentRecords(projectSourceComponents);
         const componentsToSkip = ComponentProcessor.getComponentsToSkip(projectSourceComponents, metadataEntries, project.getPath());
         enrichmentRecords.addSkippedComponents(componentsToSkip);
         enrichmentRecords.updateWithStatus(componentsToSkip, EnrichmentStatus.SKIPPED);
@@ -65,18 +74,52 @@ export default class MetadataEnrich extends SfCommand {
             }
             return true;
         });
-        this.spinner.stop();
-        this.spinner.start(commandMessages.getMessage('spinner.executing', [componentsEligibleToProcess.length]));
+        mso.next();
         const connection = org.getConnection();
         const enrichmentResults = await EnrichmentHandler.enrich(connection, componentsEligibleToProcess);
         enrichmentRecords.updateWithResults(enrichmentResults);
-        this.spinner.stop();
-        this.spinner.start(commandMessages.getMessage('spinner.updating.files'));
+        mso.next();
         const fileUpdatedRecords = await FileProcessor.updateMetadataFiles(componentsEligibleToProcess, enrichmentRecords.recordSet);
         enrichmentRecords.updateWithResults(Array.from(fileUpdatedRecords));
-        this.spinner.stop();
+        mso.stop();
         const metrics = EnrichmentMetrics.createEnrichmentMetrics(Array.from(enrichmentRecords.recordSet));
-        MetricsFormatter.logMetrics(this.log.bind(this), metrics, metricsMessages);
+        const ux = new Ux();
+        ux.log('');
+        ux.log(metricsMessages.getMessage('metrics.total.count', [metrics.total]));
+        const tableRows = [
+            ...metrics.success.components.map((c) => ({
+                status: 'Success',
+                type: c.typeName,
+                component: c.componentName,
+                message: c.message,
+            })),
+            ...metrics.skipped.components.map((c) => ({
+                status: 'Skipped',
+                type: c.typeName,
+                component: c.componentName,
+                message: c.message,
+            })),
+            ...metrics.fail.components.map((c) => ({
+                status: 'Failed',
+                type: c.typeName,
+                component: c.componentName,
+                message: c.message,
+            })),
+        ];
+        if (tableRows.length > 0) {
+            ux.log('');
+            ux.table({
+                columns: [
+                    { key: 'status', name: 'Status' },
+                    { key: 'type', name: 'Type' },
+                    { key: 'component', name: 'Component' },
+                    { key: 'message', name: 'Message' },
+                ],
+                data: tableRows,
+                overflow: 'wrap',
+            });
+        }
+        ux.log('');
         return metrics;
     }
 }

package/lib/commands/metadata/enrich.js.map

@@ -1 +1 @@
-{"version":3,"file":"enrich.js","sourceRoot":"","sources":["../../../src/commands/metadata/enrich.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"enrich.js","sourceRoot":"","sources":["../../../src/commands/metadata/enrich.ts"],"names":[],"mappings":"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"}

package/messages/metadata.enrich.md

@@ -14,6 +14,8 @@ Even though this command updates only local files in your DX project, you're sti
 
 Currently, this command supports enriching only Lightning Web Components, represented by the LightningComponentBundle metadata type.
 
+Your org must be eligible for metadata enrichment. Your Salesforce admin can help with that.
+
 # examples
 
 - Enrich the "HelloWorld" LightningComponentBundle metadata component in the local DX project; use your default org:
@@ -40,14 +42,14 @@ Metadata type and optional component name to enrich.
 
 Wildcards ("_") are supported as long as you use double quotes, such as "LightningComponentBundle:MyClass_".
 
-# spinner.setup
+# stage.setup
 
 Setting up and retrieving project source components
 
-# spinner.executing
+# stage.executing
 
-Executing metadata enrichment for %s eligible components
+Executing metadata enrichment
 
-# spinner.updating.files
+# stage.updating.files
 
 Updating metadata configuration with enriched results

package/messages/metrics.md

@@ -1,19 +1,3 @@
 # metrics.total.count
 
 Total Components Processed: %s
-
-# metrics.success.count
-
-✓ Successfully Enriched: %s
-
-# metrics.skipped.count
-
-⊘ Skipped: %s
-
-# metrics.fail.count
-
-✗ Failed: %s
-
-# metrics.message
-
-Message: %s

package/npm-shrinkwrap.json

@@ -1,18 +1,20 @@
 {
   "name": "@salesforce/plugin-metadata-enrichment",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/plugin-metadata-enrichment",
-      "version": "0.0.1",
+      "version": "0.0.3",
       "license": "Apache-2.0",
       "dependencies": {
         "@oclif/core": "^4",
+        "@oclif/multi-stage-output": "^0.8.30",
+        "@oclif/table": "^0.5.1",
         "@salesforce/core": "^8.24.0",
         "@salesforce/kit": "^3.2.4",
-        "@salesforce/metadata-enrichment": "^0.0.1",
+        "@salesforce/metadata-enrichment": "^0.0.4",
         "@salesforce/sf-plugins-core": "^12",
         "@salesforce/source-deploy-retrieve": "^12.0.1"
       },
@@ -3561,6 +3563,91 @@
         "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
       }
     },
+    "node_modules/@oclif/multi-stage-output": {
+      "version": "0.8.30",
+      "resolved": "https://registry.npmjs.org/@oclif/multi-stage-output/-/multi-stage-output-0.8.30.tgz",
+      "integrity": "sha512-WNEqTdK9GsZGc/yOgm/2drpdTXp7FGDxH3nbWSpMJBJU5CqrWmvoqNqrXZmlVRQHjKCo8qW3hI9FXse5brFVNg==",
+      "license": "MIT",
+      "dependencies": {
+        "@oclif/core": "^4",
+        "@types/react": "^18.3.12",
+        "cli-spinners": "^2",
+        "figures": "^6.1.0",
+        "ink": "5.0.1",
+        "react": "^18.3.1",
+        "wrap-ansi": "^9.0.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@oclif/multi-stage-output/node_modules/ansi-regex": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz",
+      "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/@oclif/multi-stage-output/node_modules/emoji-regex": {
+      "version": "10.6.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz",
+      "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==",
+      "license": "MIT"
+    },
+    "node_modules/@oclif/multi-stage-output/node_modules/string-width": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+      "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^10.3.0",
+        "get-east-asian-width": "^1.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@oclif/multi-stage-output/node_modules/strip-ansi": {
+      "version": "7.1.2",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz",
+      "integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
+    "node_modules/@oclif/multi-stage-output/node_modules/wrap-ansi": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz",
+      "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.2.1",
+        "string-width": "^7.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
     "node_modules/@oclif/plugin-command-snapshot": {
       "version": "5.3.8",
       "resolved": "https://registry.npmjs.org/@oclif/plugin-command-snapshot/-/plugin-command-snapshot-5.3.8.tgz",
@@ -4105,9 +4192,9 @@
       }
     },
     "node_modules/@salesforce/metadata-enrichment": {
-      "version": "0.0.1",
-      "resolved": "https://registry.npmjs.org/@salesforce/metadata-enrichment/-/metadata-enrichment-0.0.1.tgz",
-      "integrity": "sha512-8w3PKpgmXi6u0uKZCfuQ7f7YceivYml/92GSB5fHKSrIHFppBx2tVKgJPlauEnvyNj685HSxs7HPSMZ2bZWdJQ==",
+      "version": "0.0.4",
+      "resolved": "https://registry.npmjs.org/@salesforce/metadata-enrichment/-/metadata-enrichment-0.0.4.tgz",
+      "integrity": "sha512-5NPGDd0vrzxiFvB/OfaGvYyZ+4aIDaiTa7wayTqAlQsvzTKWwf26TEtRGkLFV48uNqLt4/uGC5sDfuXRQlI+uQ==",
       "license": "Apache-2.0",
       "dependencies": {
         "@salesforce/core": "^8.24.0",
@@ -5511,7 +5598,6 @@
       "resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.28.tgz",
       "integrity": "sha512-z9VXpC7MWrhfWipitjNdgCauoMLRdIILQsAEV+ZesIzBq/oUlxk0m3ApZuMFCXdnS4U7KrI+l3WRUEGQ8K1QKw==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@types/prop-types": "*",
         "csstype": "^3.2.2"
@@ -9016,6 +9102,21 @@
         "node": ">=0.8.0"
       }
     },
+    "node_modules/figures": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/figures/-/figures-6.1.0.tgz",
+      "integrity": "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg==",
+      "license": "MIT",
+      "dependencies": {
+        "is-unicode-supported": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/file-entry-cache": {
       "version": "6.0.1",
       "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-6.0.1.tgz",
@@ -10969,13 +11070,12 @@
       "license": "MIT"
     },
     "node_modules/is-unicode-supported": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-0.1.0.tgz",
-      "integrity": "sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==",
-      "dev": true,
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-2.1.0.tgz",
+      "integrity": "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==",
       "license": "MIT",
       "engines": {
-        "node": ">=10"
+        "node": ">=18"
       },
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
@@ -11814,6 +11914,19 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/log-symbols/node_modules/is-unicode-supported": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-0.1.0.tgz",
+      "integrity": "sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/loose-envify": {
       "version": "1.4.0",
       "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",

package/oclif.lock

@@ -1546,6 +1546,19 @@
     wordwrap "^1.0.0"
     wrap-ansi "^7.0.0"
 
+"@oclif/multi-stage-output@^0.8.30":
+  version "0.8.30"
+  resolved "https://registry.yarnpkg.com/@oclif/multi-stage-output/-/multi-stage-output-0.8.30.tgz#c95261d669bc466ce06701e26248f49282034a12"
+  integrity sha512-WNEqTdK9GsZGc/yOgm/2drpdTXp7FGDxH3nbWSpMJBJU5CqrWmvoqNqrXZmlVRQHjKCo8qW3hI9FXse5brFVNg==
+  dependencies:
+    "@oclif/core" "^4"
+    "@types/react" "^18.3.12"
+    cli-spinners "^2"
+    figures "^6.1.0"
+    ink "5.0.1"
+    react "^18.3.1"
+    wrap-ansi "^9.0.2"
+
 "@oclif/plugin-command-snapshot@^5.3.8":
   version "5.3.8"
   resolved "https://registry.yarnpkg.com/@oclif/plugin-command-snapshot/-/plugin-command-snapshot-5.3.8.tgz#b952a270bfdfaea941f244363c4bcf781398d9b9"
@@ -1590,7 +1603,7 @@
     lodash "^4.17.23"
     registry-auth-token "^5.1.1"
 
-"@oclif/table@^0.5.0":
+"@oclif/table@^0.5.0", "@oclif/table@^0.5.1":
   version "0.5.2"
   resolved "https://registry.yarnpkg.com/@oclif/table/-/table-0.5.2.tgz#ddedab03c61086050dd10047cb05dcea6893839c"
   integrity sha512-7QnG9tqVEDqRbCZGvCU1uueoLWdiSVqFmslOfEpEW++XkqLi8hKu3TX6J22yqrvgCwx9CnNeAkaOD2UZ9NoWKw==
@@ -1726,10 +1739,10 @@
   dependencies:
     "@salesforce/ts-types" "^2.0.12"
 
-"@salesforce/metadata-enrichment@^0.0.1":
-  version "0.0.1"
-  resolved "https://registry.yarnpkg.com/@salesforce/metadata-enrichment/-/metadata-enrichment-0.0.1.tgz#e685e3bb9676dc1141b23880a10ccc098a88ecdb"
-  integrity sha512-8w3PKpgmXi6u0uKZCfuQ7f7YceivYml/92GSB5fHKSrIHFppBx2tVKgJPlauEnvyNj685HSxs7HPSMZ2bZWdJQ==
+"@salesforce/metadata-enrichment@^0.0.4":
+  version "0.0.4"
+  resolved "https://registry.yarnpkg.com/@salesforce/metadata-enrichment/-/metadata-enrichment-0.0.4.tgz#542b2d49ef844c802942c252f602f3aed232c6ad"
+  integrity sha512-5NPGDd0vrzxiFvB/OfaGvYyZ+4aIDaiTa7wayTqAlQsvzTKWwf26TEtRGkLFV48uNqLt4/uGC5sDfuXRQlI+uQ==
   dependencies:
     "@salesforce/core" "^8.24.0"
     "@salesforce/kit" "^3.2.4"
@@ -3468,7 +3481,7 @@ cli-progress@^3.12.0:
   dependencies:
     string-width "^4.2.3"
 
-cli-spinners@^2.9.2:
+cli-spinners@^2, cli-spinners@^2.9.2:
   version "2.9.2"
   resolved "https://registry.yarnpkg.com/cli-spinners/-/cli-spinners-2.9.2.tgz#1773a8f4b9c4d6ac31563df53b3fc1d79462fe41"
   integrity sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg==
@@ -4522,6 +4535,13 @@ fdir@^6.5.0:
   resolved "https://registry.yarnpkg.com/fdir/-/fdir-6.5.0.tgz#ed2ab967a331ade62f18d077dae192684d50d350"
   integrity sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==
 
+figures@^6.1.0:
+  version "6.1.0"
+  resolved "https://registry.yarnpkg.com/figures/-/figures-6.1.0.tgz#935479f51865fa7479f6fa94fc6fc7ac14e62c4a"
+  integrity sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg==
+  dependencies:
+    is-unicode-supported "^2.0.0"
+
 file-entry-cache@^6.0.1:
   version "6.0.1"
   resolved "https://registry.yarnpkg.com/file-entry-cache/-/file-entry-cache-6.0.1.tgz#211b2dd9659cb0394b073e7323ac3c933d522027"
@@ -5584,6 +5604,11 @@ is-unicode-supported@^0.1.0:
   resolved "https://registry.yarnpkg.com/is-unicode-supported/-/is-unicode-supported-0.1.0.tgz#3f26c76a809593b52bfa2ecb5710ed2779b522a7"
   integrity sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==
 
+is-unicode-supported@^2.0.0:
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/is-unicode-supported/-/is-unicode-supported-2.1.0.tgz#09f0ab0de6d3744d48d265ebb98f65d11f2a9b3a"
+  integrity sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==
+
 is-weakmap@^2.0.2:
   version "2.0.2"
   resolved "https://registry.yarnpkg.com/is-weakmap/-/is-weakmap-2.0.2.tgz#bf72615d649dfe5f699079c54b83e47d1ae19cfd"
@@ -7913,7 +7938,16 @@ stop-iteration-iterator@^1.1.0:
     es-errors "^1.3.0"
     internal-slot "^1.1.0"
 
-"string-width-cjs@npm:string-width@^4.2.0", string-width@^4.0.0, string-width@^4.1.0, string-width@^4.2.0, string-width@^4.2.3:
+"string-width-cjs@npm:string-width@^4.2.0":
+  version "4.2.3"
+  resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010"
+  integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==
+  dependencies:
+    emoji-regex "^8.0.0"
+    is-fullwidth-code-point "^3.0.0"
+    strip-ansi "^6.0.1"
+
+string-width@^4.0.0, string-width@^4.1.0, string-width@^4.2.0, string-width@^4.2.3:
   version "4.2.3"
   resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010"
   integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==
@@ -7994,7 +8028,14 @@ stringify-entities@^4.0.0:
     character-entities-html4 "^2.0.0"
     character-entities-legacy "^3.0.0"
 
-"strip-ansi-cjs@npm:strip-ansi@^6.0.1", strip-ansi@6.0.1, strip-ansi@^6.0.0, strip-ansi@^6.0.1:
+"strip-ansi-cjs@npm:strip-ansi@^6.0.1":
+  version "6.0.1"
+  resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9"
+  integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==
+  dependencies:
+    ansi-regex "^5.0.1"
+
+strip-ansi@6.0.1, strip-ansi@^6.0.0, strip-ansi@^6.0.1:
   version "6.0.1"
   resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9"
   integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==
@@ -8669,7 +8710,7 @@ workerpool@^6.5.1:
   resolved "https://registry.yarnpkg.com/workerpool/-/workerpool-6.5.1.tgz#060f73b39d0caf97c6db64da004cd01b4c099544"
   integrity sha512-Fs4dNYcsdpYSAfVxhnl1L5zTksjvOJxtC5hzMNl+1t9B8hTJTdKDyZ5ju7ztgPy+ft9tBFXoOlDNiOT9WUXZlA==
 
-"wrap-ansi-cjs@npm:wrap-ansi@^7.0.0", wrap-ansi@^7.0.0:
+"wrap-ansi-cjs@npm:wrap-ansi@^7.0.0":
   version "7.0.0"
   resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43"
   integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==
@@ -8687,6 +8728,15 @@ wrap-ansi@^6.2.0:
     string-width "^4.1.0"
     strip-ansi "^6.0.0"
 
+wrap-ansi@^7.0.0:
+  version "7.0.0"
+  resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43"
+  integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==
+  dependencies:
+    ansi-styles "^4.0.0"
+    string-width "^4.1.0"
+    strip-ansi "^6.0.0"
+
 wrap-ansi@^8.1.0:
   version "8.1.0"
   resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-8.1.0.tgz#56dc22368ee570face1b49819975d9b9a5ead214"

package/oclif.manifest.json

@@ -3,7 +3,7 @@
     "metadata:enrich": {
       "aliases": [],
       "args": {},
-      "description": "Use this command to add AI-generated descriptions right in the metadata source files in your local DX project. These enriched descriptions succinctly outline the metadata component’s purpose and capabilities, which in turn provide context when vibe coding with an AI tool, such as Agentforce Vibes.\n\nThis command updates only the local metadata source files in your DX project; it doesn't change the components in your org. If you want the AI-generated descriptions in your org, then you must explicitly deploy the updated metadata components to your org by using, for example, the \"project deploy start\" CLI command.\n\nTo enrich multiple metadata components, specify multiple --metadata <name> flags. Enclose names that contain spaces in double quotes.\n\nEven though this command updates only local files in your DX project, you're still required to authorize and specify an org, which is how the command accesses a large language model (LLM).\n\nCurrently, this command supports enriching only Lightning Web Components, represented by the LightningComponentBundle metadata type.",
+      "description": "Use this command to add AI-generated descriptions right in the metadata source files in your local DX project. These enriched descriptions succinctly outline the metadata component’s purpose and capabilities, which in turn provide context when vibe coding with an AI tool, such as Agentforce Vibes.\n\nThis command updates only the local metadata source files in your DX project; it doesn't change the components in your org. If you want the AI-generated descriptions in your org, then you must explicitly deploy the updated metadata components to your org by using, for example, the \"project deploy start\" CLI command.\n\nTo enrich multiple metadata components, specify multiple --metadata <name> flags. Enclose names that contain spaces in double quotes.\n\nEven though this command updates only local files in your DX project, you're still required to authorize and specify an org, which is how the command accesses a large language model (LLM).\n\nCurrently, this command supports enriching only Lightning Web Components, represented by the LightningComponentBundle metadata type.\n\nYour org must be eligible for metadata enrichment. Your Salesforce admin can help with that.",
       "examples": [
         "Enrich the \"HelloWorld\" LightningComponentBundle metadata component in the local DX project; use your default org:\n<%= config.bin %> <%= command.id %> --metadata LightningComponentBundle:HelloWorld",
         "Enrich the \"HelloWorld\" LightningComponentBundle metadata component and use the org with alias \"my-org\":\n<%= config.bin %> <%= command.id %> --metadata LightningComponentBundle:HelloWorld --target-org my-org",
@@ -53,6 +53,7 @@
       "pluginAlias": "@salesforce/plugin-metadata-enrichment",
       "pluginName": "@salesforce/plugin-metadata-enrichment",
       "pluginType": "core",
+      "state": "preview",
       "strict": true,
       "summary": "Enrich metadata components in your DX project by adding AI-generated descriptions.",
       "enableJsonFlag": true,
@@ -70,5 +71,5 @@
       ]
     }
   },
-  "version": "0.0.1"
+  "version": "0.0.3"
 }

package/package.json

@@ -1,14 +1,16 @@
 {
     "name": "@salesforce/plugin-metadata-enrichment",
     "description": "A Salesforce CLI plugin to enrich metadata for Salesforce resources",
-    "version": "0.0.1",
+    "version": "0.0.3",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
         "@oclif/core": "^4",
+        "@oclif/multi-stage-output": "^0.8.30",
+        "@oclif/table": "^0.5.1",
         "@salesforce/core": "^8.24.0",
         "@salesforce/kit": "^3.2.4",
-        "@salesforce/metadata-enrichment": "^0.0.1",
+        "@salesforce/metadata-enrichment": "^0.0.4",
         "@salesforce/sf-plugins-core": "^12",
         "@salesforce/source-deploy-retrieve": "^12.0.1"
     },
@@ -201,7 +203,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-metadata-enrichment/0.0.1.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-metadata-enrichment/0.0.1.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-metadata-enrichment/0.0.3.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-metadata-enrichment/0.0.3.sig"
     }
 }

package/schemas/metadata-enrich.json

@@ -18,7 +18,10 @@
               }
             }
           },
-          "required": ["count", "components"],
+          "required": [
+            "count",
+            "components"
+          ],
           "additionalProperties": false
         },
         "fail": {
@@ -34,7 +37,10 @@
               }
             }
           },
-          "required": ["count", "components"],
+          "required": [
+            "count",
+            "components"
+          ],
           "additionalProperties": false
         },
         "skipped": {
@@ -50,15 +56,24 @@
               }
             }
           },
-          "required": ["count", "components"],
+          "required": [
+            "count",
+            "components"
+          ],
           "additionalProperties": false
         },
         "total": {
           "type": "number"
         }
       },
-      "required": ["success", "fail", "skipped", "total"],
-      "additionalProperties": false
+      "required": [
+        "success",
+        "fail",
+        "skipped",
+        "total"
+      ],
+      "additionalProperties": false,
+      "description": "A metrics data object for storing the final enrichment results. This includes components that were successfully enriched, failed, or skipped. This metrics object can be used to generate the final console or json output."
     },
     "ComponentEnrichmentStatus": {
       "type": "object",
@@ -74,7 +89,11 @@
           "type": "string"
         }
       },
-      "required": ["componentName", "message", "typeName"]
+      "required": [
+        "componentName",
+        "message",
+        "typeName"
+      ]
     }
   }
-}
+}

package/lib/component/componentProcessor.d.ts

@@ -1,24 +0,0 @@
-import { type SourceComponent } from '@salesforce/source-deploy-retrieve';
-import type { MetadataTypeAndName } from '@salesforce/metadata-enrichment';
-export declare class ComponentProcessor {
-    /**
-     *
-     * Determine the components to SKIP based on the source components and the metadata entries.
-     * This includes:
-     * - Input components that do not exist in the source project
-     * - Non-LWC components
-     * - LWC components that are missing their metadata configuration file
-     *
-     * @param sourceComponents
-     * @param metadataEntries
-     * @param projectDir
-     * @returns
-     */
-    static getComponentsToSkip(sourceComponents: SourceComponent[], metadataEntries: string[], projectDir?: string): Set<MetadataTypeAndName>;
-    private static filterComponents;
-    private static diffRequestedComponents;
-    private static parseRequestedComponents;
-    private static getExistingSourceComponentNames;
-    private static createSourceComponentMap;
-    private static parseMetadataEntry;
-}

package/lib/component/componentProcessor.js

@@ -1,132 +0,0 @@
-/*
- * Copyright 2026, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { RegistryAccess } from '@salesforce/source-deploy-retrieve';
-export class ComponentProcessor {
-    /**
-     *
-     * Determine the components to SKIP based on the source components and the metadata entries.
-     * This includes:
-     * - Input components that do not exist in the source project
-     * - Non-LWC components
-     * - LWC components that are missing their metadata configuration file
-     *
-     * @param sourceComponents
-     * @param metadataEntries
-     * @param projectDir
-     * @returns
-     */
-    static getComponentsToSkip(sourceComponents, metadataEntries, projectDir) {
-        const requestedComponents = ComponentProcessor.parseRequestedComponents(metadataEntries, projectDir);
-        const missingComponents = ComponentProcessor.diffRequestedComponents(sourceComponents, requestedComponents);
-        const filteredComponents = ComponentProcessor.filterComponents(sourceComponents, requestedComponents);
-        return new Set([...missingComponents, ...filteredComponents]);
-    }
-    static filterComponents(sourceComponents, requestedComponents) {
-        const sourceComponentMap = ComponentProcessor.createSourceComponentMap(sourceComponents);
-        const filteredComponents = new Set();
-        for (const requestedComponent of requestedComponents) {
-            if (!requestedComponent?.componentName)
-                continue;
-            const sourceComponent = sourceComponentMap.get(requestedComponent.componentName);
-            if (!sourceComponent)
-                continue;
-            // Filter out non-LWC components
-            if (sourceComponent.type?.name !== 'LightningComponentBundle') {
-                filteredComponents.add({
-                    typeName: sourceComponent.type.name,
-                    componentName: requestedComponent.componentName,
-                });
-            }
-            // Filter out LWC components that are missing the metadata xml file
-            else if (sourceComponent.type?.name === 'LightningComponentBundle' && !sourceComponent.xml) {
-                filteredComponents.add({
-                    typeName: sourceComponent.type.name,
-                    componentName: requestedComponent.componentName,
-                });
-            }
-        }
-        return filteredComponents;
-    }
-    static diffRequestedComponents(sourceComponents, requestedComponents) {
-        const existingSourceComponentNames = ComponentProcessor.getExistingSourceComponentNames(sourceComponents);
-        const missingComponents = new Set();
-        for (const requestedComponent of requestedComponents) {
-            if (requestedComponent.componentName && !existingSourceComponentNames.has(requestedComponent.componentName)) {
-                missingComponents.add(requestedComponent);
-            }
-        }
-        return missingComponents;
-    }
-    static parseRequestedComponents(metadataEntries, projectDir) {
-        const requestedComponents = new Set();
-        for (const entry of metadataEntries) {
-            const parsed = ComponentProcessor.parseMetadataEntry(entry, projectDir);
-            if (!parsed) {
-                continue;
-            }
-            // Ignore wildcarded component names
-            if (parsed.componentName?.includes('*')) {
-                continue;
-            }
-            requestedComponents.add(parsed);
-        }
-        return requestedComponents;
-    }
-    static getExistingSourceComponentNames(sourceComponents) {
-        const existingSourceComponentNames = new Set();
-        for (const component of sourceComponents) {
-            const componentName = component.fullName ?? component.name;
-            if (componentName) {
-                existingSourceComponentNames.add(componentName);
-            }
-        }
-        return existingSourceComponentNames;
-    }
-    static createSourceComponentMap(sourceComponents) {
-        const componentMap = new Map();
-        for (const component of sourceComponents) {
-            const componentName = component.fullName ?? component.name;
-            if (componentName) {
-                componentMap.set(componentName, component);
-            }
-        }
-        return componentMap;
-    }
-    static parseMetadataEntry(rawEntry, projectDir) {
-        try {
-            const registry = new RegistryAccess(undefined, projectDir);
-            // Split on the first colon, and then join the rest back together to support names that include colons
-            const [typeName, ...nameParts] = rawEntry.split(':');
-            const type = registry.getTypeByName(typeName.trim());
-            if (!type) {
-                return null;
-            }
-            const metadataName = nameParts.length > 0 ? nameParts.join(':').trim() : '*';
-            // Return null for wildcards since componentName is required
-            if (metadataName === '*') {
-                return null;
-            }
-            return {
-                typeName: type.name,
-                componentName: metadataName,
-            };
-        }
-        catch {
-            return null;
-        }
-    }
-}
-//# sourceMappingURL=componentProcessor.js.map

package/lib/component/componentProcessor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"componentProcessor.js","sourceRoot":"","sources":["../../src/component/componentProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAwB,MAAM,oCAAoC,CAAC;AAG1F,MAAM,OAAO,kBAAkB;IAC7B;;;;;;;;;;;;OAYG;IACI,MAAM,CAAC,mBAAmB,CAC/B,gBAAmC,EACnC,eAAyB,EACzB,UAAmB;QAEnB,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,wBAAwB,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QACrG,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,uBAAuB,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;QAC5G,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;QACtG,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,iBAAiB,EAAE,GAAG,kBAAkB,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAC7B,gBAAmC,EACnC,mBAAoD;QAEpD,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;QACzF,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAuB,CAAC;QAE1D,KAAK,MAAM,kBAAkB,IAAI,mBAAmB,EAAE,CAAC;YACrD,IAAI,CAAC,kBAAkB,EAAE,aAAa;gBAAE,SAAS;YAEjD,MAAM,eAAe,GAAG,kBAAkB,CAAC,GAAG,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;YACjF,IAAI,CAAC,eAAe;gBAAE,SAAS;YAE/B,gCAAgC;YAChC,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,KAAK,0BAA0B,EAAE,CAAC;gBAC9D,kBAAkB,CAAC,GAAG,CAAC;oBACrB,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI;oBACnC,aAAa,EAAE,kBAAkB,CAAC,aAAa;iBAChD,CAAC,CAAC;YACL,CAAC;YACD,mEAAmE;iBAC9D,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,KAAK,0BAA0B,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC;gBAC3F,kBAAkB,CAAC,GAAG,CAAC;oBACrB,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI;oBACnC,aAAa,EAAE,kBAAkB,CAAC,aAAa;iBAChD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAEO,MAAM,CAAC,uBAAuB,CACpC,gBAAmC,EACnC,mBAA6C;QAE7C,MAAM,4BAA4B,GAAG,kBAAkB,CAAC,+BAA+B,CAAC,gBAAgB,CAAC,CAAC;QAC1G,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAuB,CAAC;QACzD,KAAK,MAAM,kBAAkB,IAAI,mBAAmB,EAAE,CAAC;YACrD,IAAI,kBAAkB,CAAC,aAAa,IAAI,CAAC,4BAA4B,CAAC,GAAG,CAAC,kBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC5G,iBAAiB,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAEO,MAAM,CAAC,wBAAwB,CAAC,eAAyB,EAAE,UAAmB;QACpF,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAuB,CAAC;QAE3D,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,kBAAkB,CAAC,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACxE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,SAAS;YACX,CAAC;YAED,oCAAoC;YACpC,IAAI,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,SAAS;YACX,CAAC;YAED,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAEO,MAAM,CAAC,+BAA+B,CAAC,gBAAmC;QAChF,MAAM,4BAA4B,GAAG,IAAI,GAAG,EAAU,CAAC;QACvD,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;YACzC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC;YAC3D,IAAI,aAAa,EAAE,CAAC;gBAClB,4BAA4B,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAEO,MAAM,CAAC,wBAAwB,CAAC,gBAAmC;QACzE,MAAM,YAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;QAExD,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;YACzC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC;YAC3D,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,QAAgB,EAAE,UAAmB;QACrE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAC3D,sGAAsG;YACtG,MAAM,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAC7E,4DAA4D;YAC5D,IAAI,YAAY,KAAK,GAAG,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,aAAa,EAAE,YAAY;aAC5B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/lib/component/index.d.ts

@@ -1 +0,0 @@
-export { ComponentProcessor } from './componentProcessor.js';

package/lib/component/index.js

@@ -1,17 +0,0 @@
-/*
- * Copyright 2026, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-export { ComponentProcessor } from './componentProcessor.js';
-//# sourceMappingURL=index.js.map

package/lib/component/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/component/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/lib/utils/enrichmentRecords.d.ts

@@ -1,12 +0,0 @@
-import type { SourceComponent } from '@salesforce/source-deploy-retrieve';
-import type { Messages } from '@salesforce/core';
-import { EnrichmentStatus, type EnrichmentRequestRecord, type MetadataTypeAndName } from '@salesforce/metadata-enrichment';
-export declare class EnrichmentRecords {
-    readonly recordSet: Set<EnrichmentRequestRecord>;
-    private readonly errorMessages;
-    constructor(projectSourceComponents: SourceComponent[], errorMessages: Messages<string>);
-    addSkippedComponents(componentsToSkip: Set<MetadataTypeAndName>): void;
-    updateWithStatus(componentsToUpdate: Set<MetadataTypeAndName>, status: EnrichmentStatus): void;
-    updateWithResults(results: EnrichmentRequestRecord[]): void;
-    generateSkipReasons(componentsToSkip: Set<MetadataTypeAndName>, projectSourceComponents: SourceComponent[]): void;
-}

package/lib/utils/enrichmentRecords.js

@@ -1,117 +0,0 @@
-/*
- * Copyright 2026, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { EnrichmentStatus, } from '@salesforce/metadata-enrichment';
-export class EnrichmentRecords {
-    recordSet;
-    errorMessages;
-    constructor(projectSourceComponents, errorMessages) {
-        this.errorMessages = errorMessages;
-        this.recordSet = new Set();
-        // Create initial records for all provided source components
-        for (const component of projectSourceComponents) {
-            const componentName = component.fullName ?? component.name;
-            if (componentName && component.type) {
-                this.recordSet.add({
-                    componentName,
-                    componentType: component.type,
-                    requestBody: { contentBundles: [], metadataType: 'Generic', maxTokens: 50 },
-                    response: null,
-                    message: null,
-                    status: EnrichmentStatus.NOT_PROCESSED,
-                });
-            }
-        }
-    }
-    addSkippedComponents(componentsToSkip) {
-        for (const component of componentsToSkip) {
-            if (!component.componentName)
-                continue;
-            // Check if record already exists
-            const existingRecord = Array.from(this.recordSet).find((r) => r.componentName === component.componentName);
-            if (existingRecord)
-                continue;
-            // Create a new record for the skipped component
-            this.recordSet.add({
-                componentName: component.componentName,
-                componentType: { name: component.typeName },
-                requestBody: { contentBundles: [], metadataType: 'Generic', maxTokens: 50 },
-                response: null,
-                message: null,
-                status: EnrichmentStatus.SKIPPED,
-            });
-        }
-    }
-    updateWithStatus(componentsToUpdate, status) {
-        const componentsToUpdateMap = new Map();
-        for (const component of componentsToUpdate) {
-            if (component.componentName) {
-                componentsToUpdateMap.set(component.componentName, component);
-            }
-        }
-        for (const record of this.recordSet) {
-            const componentToUpdate = componentsToUpdateMap.get(record.componentName);
-            if (componentToUpdate) {
-                record.status = status;
-            }
-        }
-    }
-    updateWithResults(results) {
-        const resultsMap = new Map(results.map((r) => [r.componentName, r]));
-        for (const record of this.recordSet) {
-            const processedResult = resultsMap.get(record.componentName);
-            if (processedResult) {
-                record.requestBody = processedResult.requestBody;
-                record.response = processedResult.response;
-                if (record.status !== EnrichmentStatus.SKIPPED) {
-                    record.status = processedResult.response ? EnrichmentStatus.SUCCESS : EnrichmentStatus.FAIL;
-                }
-                record.message = processedResult.message;
-            }
-        }
-    }
-    generateSkipReasons(componentsToSkip, projectSourceComponents) {
-        const sourceComponentMap = new Map();
-        for (const component of projectSourceComponents) {
-            const componentName = component.fullName ?? component.name;
-            if (componentName) {
-                sourceComponentMap.set(componentName, component);
-            }
-        }
-        for (const skip of componentsToSkip) {
-            if (!skip.componentName)
-                continue;
-            const record = Array.from(this.recordSet).find((r) => r.componentName === skip.componentName);
-            if (!record || record.status !== EnrichmentStatus.SKIPPED || record.message)
-                continue;
-            const sourceComponent = sourceComponentMap.get(skip.componentName);
-            let message;
-            if (!sourceComponent) {
-                message = this.errorMessages.getMessage('errors.component.not.found');
-            }
-            else if (sourceComponent?.type?.name !== 'LightningComponentBundle') {
-                message = this.errorMessages.getMessage('errors.lwc.only');
-            }
-            else if (sourceComponent?.type?.name === 'LightningComponentBundle' && !sourceComponent.xml) {
-                message = this.errorMessages.getMessage('errors.lwc.configuration.not.found');
-            }
-            else {
-                message = this.errorMessages.getMessage('errors.unknown');
-            }
-            record.message = message;
-        }
-    }
-}
-//# sourceMappingURL=enrichmentRecords.js.map

package/lib/utils/enrichmentRecords.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"enrichmentRecords.js","sourceRoot":"","sources":["../../src/utils/enrichmentRecords.ts"],"names":[],"mappings":"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"}

package/lib/utils/index.d.ts

@@ -1,2 +0,0 @@
-export { MetricsFormatter } from './metricsFormatter.js';
-export { EnrichmentRecords } from './enrichmentRecords.js';

package/lib/utils/index.js

@@ -1,18 +0,0 @@
-/*
- * Copyright 2026, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-export { MetricsFormatter } from './metricsFormatter.js';
-export { EnrichmentRecords } from './enrichmentRecords.js';
-//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/lib/utils/metricsFormatter.d.ts

@@ -1,12 +0,0 @@
-import type { Messages } from '@salesforce/core';
-import type { EnrichmentMetrics } from '@salesforce/metadata-enrichment';
-export declare class MetricsFormatter {
-    /**
-     * Log the formatted enrichment metrics to the console
-     *
-     * @param log
-     * @param metrics
-     * @param metricsMessages
-     */
-    static logMetrics(log: (message: string) => void, metrics: EnrichmentMetrics, metricsMessages: Messages<string>): void;
-}

package/lib/utils/metricsFormatter.js

@@ -1,62 +0,0 @@
-/*
- * Copyright 2026, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-export class MetricsFormatter {
-    /**
-     * Log the formatted enrichment metrics to the console
-     *
-     * @param log
-     * @param metrics
-     * @param metricsMessages
-     */
-    static logMetrics(log, metrics, metricsMessages) {
-        log('');
-        log(metricsMessages.getMessage('metrics.total.count', [metrics.total]));
-        log('');
-        // Success section
-        log(metricsMessages.getMessage('metrics.success.count', [metrics.success.count]));
-        if (metrics.success.components.length > 0) {
-            for (const component of metrics.success.components) {
-                log(`  • ${component.typeName}:${component.componentName ?? '*'}`);
-            }
-        }
-        log('');
-        // Skipped section
-        log(metricsMessages.getMessage('metrics.skipped.count', [metrics.skipped.count]));
-        if (metrics.skipped.components.length > 0) {
-            for (const component of metrics.skipped.components) {
-                log(`  • ${component.typeName}:${component.componentName ?? '*'}`);
-                if (component.message) {
-                    log(`    ` + metricsMessages.getMessage(`metrics.message`, [component.message]));
-                    log('');
-                }
-            }
-        }
-        log('');
-        // Failed section
-        log(metricsMessages.getMessage('metrics.fail.count', [metrics.fail.count]));
-        if (metrics.fail.components.length > 0) {
-            for (const component of metrics.fail.components) {
-                log(`  • ${component.typeName}:${component.componentName ?? '*'}`);
-                if (component.message) {
-                    log(`    ` + metricsMessages.getMessage(`metrics.message`, [component.message]));
-                    log('');
-                }
-            }
-        }
-        log('');
-    }
-}
-//# sourceMappingURL=metricsFormatter.js.map

package/lib/utils/metricsFormatter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"metricsFormatter.js","sourceRoot":"","sources":["../../src/utils/metricsFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,OAAO,gBAAgB;IAC3B;;;;;;OAMG;IACI,MAAM,CAAC,UAAU,CACtB,GAA8B,EAC9B,OAA0B,EAC1B,eAAiC;QAEjC,GAAG,CAAC,EAAE,CAAC,CAAC;QACR,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxE,GAAG,CAAC,EAAE,CAAC,CAAC;QAER,kBAAkB;QAClB,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBACnD,GAAG,CAAC,OAAO,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,aAAa,IAAI,GAAG,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QACD,GAAG,CAAC,EAAE,CAAC,CAAC;QAER,kBAAkB;QAClB,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBACnD,GAAG,CAAC,OAAO,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,aAAa,IAAI,GAAG,EAAE,CAAC,CAAC;gBACnE,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;oBACtB,GAAG,CAAC,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBACjF,GAAG,CAAC,EAAE,CAAC,CAAC;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QACD,GAAG,CAAC,EAAE,CAAC,CAAC;QAER,iBAAiB;QACjB,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChD,GAAG,CAAC,OAAO,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,aAAa,IAAI,GAAG,EAAE,CAAC,CAAC;gBACnE,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;oBACtB,GAAG,CAAC,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBACjF,GAAG,CAAC,EAAE,CAAC,CAAC;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QACD,GAAG,CAAC,EAAE,CAAC,CAAC;IACV,CAAC;CACF"}