Adds some telemetry to start work flow

(#3621)

Author: sergeibbb

docs/telemetry-events.md

@@ -1310,6 +1310,38 @@ void
 }
 ```
 
+### startWork/open
+
+> Sent when the user opens Start Work; use `instance` to correlate a StartWork "session"
+
+```typescript
+{
+  'instance': number
+}
+```
+
+### startWork/opened
+
+> Sent when the launchpad is opened; use `instance` to correlate a StartWork "session"
+
+```typescript
+{
+  'instance': number,
+  'connected': false | true
+}
+```
+
+### startWork/steps/connect
+
+> Sent when the Start Work has "reloaded" (while open, e.g. user refreshed or back button) and is disconnected; use `instance` to correlate a Start Work "session"
+
+```typescript
+{
+  'instance': number,
+  'connected': false | true
+}
+```
+
 ### openReviewMode
 
 > Sent when a PR review was started in the inspect overview

src/constants.telemetry.ts

@@ -297,6 +297,17 @@ export type TelemetryEvents = {
 		duration: number;
 	};
 
+	/** Sent when the user opens Start Work; use `instance` to correlate a StartWork "session" */
+	'startWork/open': StartWorkEventDataBase;
+	/** Sent when the launchpad is opened; use `instance` to correlate a StartWork "session" */
+	'startWork/opened': StartWorkEventData & {
+		connected: boolean;
+	};
+	/** Sent when the Start Work has "reloaded" (while open, e.g. user refreshed or back button) and is disconnected; use `instance` to correlate a Start Work "session" */
+	'startWork/steps/connect': StartWorkEventData & {
+		connected: boolean;
+	};
+
 	/** Sent when a PR review was started in the inspect overview */
 	openReviewMode: {
 		provider: string;
@@ -446,6 +457,14 @@ export type CommandEventData =
 			webview?: string;
 	  };
 
+export type StartWorkTelemetryContext = StartWorkEventDataBase;
+
+type StartWorkEventDataBase = {
+	instance: number;
+};
+
+type StartWorkEventData = StartWorkEventDataBase;
+
 export type LaunchpadTelemetryContext = LaunchpadEventData;
 
 type LaunchpadEventDataBase = {

src/plus/startWork/startWork.ts

@@ -23,13 +23,15 @@ import { proBadge } from '../../constants';
 import { Commands } from '../../constants.commands';
 import type { IntegrationId } from '../../constants.integrations';
 import { HostingIntegrationId } from '../../constants.integrations';
+import type { Source, Sources, StartWorkTelemetryContext } from '../../constants.telemetry';
 import type { Container } from '../../container';
 import { PlusFeatures } from '../../features';
 import type { SearchedIssue } from '../../git/models/issue';
 import type { QuickPickItemOfT } from '../../quickpicks/items/common';
 import { createQuickPickItemOfT, createQuickPickSeparator } from '../../quickpicks/items/common';
 import type { DirectiveQuickPickItem } from '../../quickpicks/items/directive';
 import { createDirectiveQuickPickItem, Directive, isDirectiveQuickPickItem } from '../../quickpicks/items/directive';
+import { getScopedCounter } from '../../system/counter';
 import { fromNow } from '../../system/date';
 import { some } from '../../system/iterable';
 import { executeCommand } from '../../system/vscode/command';
@@ -48,6 +50,7 @@ export type StartWorkResult = { items: StartWorkItem[] };
 interface Context {
 	result: StartWorkResult;
 	title: string;
+	telemetryContext: StartWorkTelemetryContext | undefined;
 	connectedIntegrations: Map<IntegrationId, boolean>;
 }
 
@@ -62,6 +65,7 @@ export type StartWorkAction = 'start';
 
 export interface StartWorkCommandArgs {
 	readonly command: 'startWork';
+	source?: Sources;
 }
 
 function assertsStartWorkStepState(state: StepState<State>): asserts state is StartWorkStepState {
@@ -72,13 +76,23 @@ function assertsStartWorkStepState(state: StepState<State>): asserts state is St
 }
 
 export const supportedStartWorkIntegrations = [HostingIntegrationId.GitHub];
+const instanceCounter = getScopedCounter();
 
 export class StartWorkCommand extends QuickCommand<State> {
-	constructor(container: Container) {
+	private readonly source: Source;
+	private readonly telemetryContext: StartWorkTelemetryContext | undefined;
+	constructor(container: Container, args?: StartWorkCommandArgs) {
 		super(container, 'startWork', 'startWork', `Start Work\u00a0\u00a0${proBadge}`, {
 			description: 'Start work on an issue',
 		});
 
+		this.source = { source: args?.source ?? 'commandPalette' };
+
+		if (this.container.telemetry.enabled) {
+			this.telemetryContext = { instance: instanceCounter.next() };
+			this.container.telemetry.sendEvent('startWork/open', { ...this.telemetryContext }, this.source);
+		}
+
 		this.initialState = {
 			counter: 0,
 		};
@@ -92,14 +106,26 @@ export class StartWorkCommand extends QuickCommand<State> {
 		const context: Context = {
 			result: { items: [] },
 			title: this.title,
+			telemetryContext: this.telemetryContext,
 			connectedIntegrations: await this.getConnectedIntegrations(),
 		};
 
+		const opened = false;
 		while (this.canStepsContinue(state)) {
 			context.title = this.title;
 
 			const hasConnectedIntegrations = [...context.connectedIntegrations.values()].some(c => c);
 			if (!hasConnectedIntegrations) {
+				if (this.container.telemetry.enabled) {
+					this.container.telemetry.sendEvent(
+						opened ? 'startWork/steps/connect' : 'startWork/opened',
+						{
+							...context.telemetryContext!,
+							connected: false,
+						},
+						this.source,
+					);
+				}
 				const result = yield* this.confirmCloudIntegrationsConnectStep(state, context);
 				if (result === StepResultBreak) {
 					return result;