Updates terminology and adds telemetry

Author: axosoft-ramint

contributions.json

@@ -312,7 +312,7 @@
 			"commandPalette": "gitlens:enabled && !gitlens:untrusted && gitlens:gk:organization:ai:enabled"
 		},
 		"gitlens.ai.mcp.install": {
-			"label": "Install MCP Server",
+			"label": "Install GitKraken MCP Server",
 			"commandPalette": "gitlens:enabled && !gitlens:untrusted && gitlens:gk:organization:ai:enabled"
 		},
 		"gitlens.ai.rebaseOntoCommit:graph": {

docs/telemetry-events.md

@@ -570,6 +570,40 @@ void
 }
 ```
 
+### cli/install/failed
+
+> Sent when a CLI install attempt fails
+
+```typescript
+{
+  'attempts': number,
+  'autoInstall': boolean,
+  'error.message': string
+}
+```
+
+### cli/install/started
+
+> Sent when a CLI install attempt is started
+
+```typescript
+{
+  'attempts': number,
+  'autoInstall': boolean
+}
+```
+
+### cli/install/succeeded
+
+> Sent when a CLI install attempt succeeds
+
+```typescript
+{
+  'attempts': number,
+  'autoInstall': boolean
+}
+```
+
 ### cloudIntegrations/connected
 
 > Sent when connected to one or more cloud-based integrations from gkdev
@@ -2726,6 +2760,35 @@ void
 }
 ```
 
+### mcp/setup/completed
+
+> Sent when GitKraken MCP setup is completed
+
+```typescript
+{
+  'requiresUserCompletion': boolean
+}
+```
+
+### mcp/setup/failed
+
+> Sent when GitKraken MCP setup fails
+
+```typescript
+{
+  'error.message': string,
+  'reason': string
+}
+```
+
+### mcp/setup/started
+
+> Sent when GitKraken MCP setup is started
+
+```typescript
+void
+```
+
 ### openReviewMode
 
 > Sent when a PR review was started in the inspect overview

package.json

@@ -6298,7 +6298,7 @@
 			},
 			{
 				"command": "gitlens.ai.mcp.install",
-				"title": "Install MCP Server",
+				"title": "Install GitKraken MCP Server",
 				"category": "GitLens"
 			},
 			{

src/constants.storage.ts

@@ -63,8 +63,6 @@ export type DeprecatedGlobalStorage = {
 };
 
 export type GlobalStorage = {
-	'ai:mcp:install': string;
-	'ai:mcp:installPath': string;
 	avatars: [string, StoredAvatar][];
 	'confirm:ai:generateCommits': boolean;
 	'confirm:ai:generateRebase': boolean;
@@ -85,7 +83,9 @@ export type GlobalStorage = {
 	// Value based on `currentOnboardingVersion` in composer's protocol
 	'composer:onboarding:dismissed': string;
 	'composer:onboarding:stepReached': number;
-	'gk:cli:installedPath': string;
+	'gk:cli:install': { status: 'attempted' | 'unsupported' | 'completed'; attempts: number };
+	'gk:cli:corePath': string;
+	'gk:cli:path': string;
 	'home:sections:collapsed': string[];
 	'home:walkthrough:dismissed': boolean;
 	'launchpad:groups:collapsed': StoredLaunchpadGroup[];

src/constants.telemetry.ts

@@ -79,6 +79,13 @@ export interface TelemetryEvents extends WebviewShowAbortedEvents, WebviewShownE
 	/** Sent when user opts in to AI All Access */
 	'aiAllAccess/optedIn': void;
 
+	/** Sent when a CLI install attempt is started */
+	'cli/install/started': CLIInstallStartedEvent;
+	/** Sent when a CLI install attempt succeeds */
+	'cli/install/succeeded': CLIInstallSucceededEvent;
+	/** Sent when a CLI install attempt fails */
+	'cli/install/failed': CLIInstallFailedEvent;
+
 	/** Sent when connecting to one or more cloud-based integrations */
 	'cloudIntegrations/connecting': CloudIntegrationsConnectingEvent;
 
@@ -238,6 +245,13 @@ export interface TelemetryEvents extends WebviewShowAbortedEvents, WebviewShownE
 	/** Sent when a launchpad operation is taking longer than a set timeout to complete */
 	'launchpad/operation/slow': LaunchpadOperationSlowEvent;
 
+	/** Sent when GitKraken MCP setup is started */
+	'mcp/setup/started': void;
+	/** Sent when GitKraken MCP setup is completed */
+	'mcp/setup/completed': MCPSetupCompletedEvent;
+	/** Sent when GitKraken MCP setup fails */
+	'mcp/setup/failed': MCPSetupFailedEvent;
+
 	/** Sent when a PR review was started in the inspect overview */
 	openReviewMode: OpenReviewModeEvent;
 
@@ -472,6 +486,31 @@ export interface AIFeedbackEvent extends AIEventDataBase {
 	'unhelpful.custom'?: string;
 }
 
+export interface CLIInstallStartedEvent {
+	autoInstall: boolean;
+	attempts: number;
+}
+
+export interface CLIInstallSucceededEvent {
+	autoInstall: boolean;
+	attempts: number;
+}
+
+export interface CLIInstallFailedEvent {
+	autoInstall: boolean;
+	attempts: number;
+	'error.message'?: string;
+}
+
+export interface MCPSetupCompletedEvent {
+	requiresUserCompletion: boolean;
+}
+
+export interface MCPSetupFailedEvent {
+	reason: string;
+	'error.message'?: string;
+}
+
 interface CloudIntegrationsConnectingEvent {
 	'integration.ids': string | undefined;
 }