telemetry for function-testing-helpers usage tracking

Author: saga-dasgupta

packages/app/src/cli/commands/app/function/run.ts

@@ -7,6 +7,7 @@ import {globalFlags, jsonFlag} from '@shopify/cli-kit/node/cli'
 import {Flags} from '@oclif/core'
 import {renderAutocompletePrompt, isTTY} from '@shopify/cli-kit/node/ui'
 import {outputDebug} from '@shopify/cli-kit/node/output'
+import {addPublicMetadata} from '@shopify/cli-kit/node/metadata'
 
 const DEFAULT_FUNCTION_EXPORT = '_start'
 
@@ -33,11 +34,24 @@ export default class FunctionRun extends AppUnlinkedCommand {
       description: 'Name of the WebAssembly export to invoke.',
       env: 'SHOPIFY_FLAG_EXPORT',
     }),
+    'invoked-by': Flags.string({
+      hidden: true,
+      description: 'Internal flag to track which client invoked this command.',
+      env: 'SHOPIFY_FLAG_INVOKED_BY',
+    }),
   }
 
   public async run(): Promise<AppUnlinkedCommandOutput> {
     const {flags} = await this.parse(FunctionRun)
 
+    // Track which client invoked this command
+    const invokedBy = flags['invoked-by']
+    if (invokedBy) {
+      await addPublicMetadata(() => ({
+        cmd_app_function_run_invoked_by: invokedBy,
+      }))
+    }
+
     let functionExport = DEFAULT_FUNCTION_EXPORT
 
     const app = await localAppContext({

packages/cli-kit/src/public/node/monorail.ts

@@ -88,6 +88,9 @@ export interface Schemas {
       cmd_app_warning_api_key_deprecation_displayed?: Optional<boolean>
       cmd_app_deployment_mode?: Optional<string>
 
+      // Function related commands
+      cmd_app_function_run_invoked_by?: Optional<string>
+
       // Dev related commands
       cmd_dev_tunnel_type?: Optional<string>
       cmd_dev_tunnel_custom_hash?: Optional<string>

packages/cli/oclif.manifest.json

@@ -1131,6 +1131,15 @@
           "name": "input",
           "type": "option"
         },
+        "invoked-by": {
+          "description": "Internal flag to track which client invoked this command.",
+          "env": "SHOPIFY_FLAG_INVOKED_BY",
+          "hasDynamicHelp": false,
+          "hidden": true,
+          "multiple": false,
+          "name": "invoked-by",
+          "type": "option"
+        },
         "json": {
           "allowNo": false,
           "char": "j",