Add output channel command and error actions to Launchpad

(#4492, #4748)

Introduces a "Show Output Channel" command accessible via command palette and context menus, with appropriate icons and menu placements. Enhances the Launchpad view to display actionable error messages, distinguishing authentication errors from general failures, and adds context-specific actions for resolving them. Improves user experience by making error states more visible and easier to address directly from the UI.

Author: sergeibbb

contributions.json

@@ -4239,7 +4239,17 @@
 		},
 		"gitlens.plus.cloudIntegrations.manage": {
 			"label": "Manage Integrations...",
-			"commandPalette": "gitlens:plus"
+			"icon": "$(plug)",
+			"commandPalette": "gitlens:plus",
+			"menus": {
+				"view/item/context": [
+					{
+						"when": "viewItem =~ /gitlens:launchpad:error\\+auth/",
+						"group": "inline",
+						"order": 1
+					}
+				]
+			}
 		},
 		"gitlens.plus.hide": {
 			"label": "Hide Pro Features",
@@ -4990,6 +5000,20 @@
 				]
 			}
 		},
+		"gitlens.showOutputChannel": {
+			"label": "Show Output Channel",
+			"icon": "$(output)",
+			"commandPalette": "gitlens:enabled",
+			"menus": {
+				"view/item/context": [
+					{
+						"when": "viewItem =~ /gitlens:launchpad:error/",
+						"group": "inline",
+						"order": 2
+					}
+				]
+			}
+		},
 		"gitlens.showPatchDetailsPage": {
 			"label": "Show Patch Details",
 			"commandPalette": "gitlens:enabled && gitlens:gk:organization:drafts:enabled && config.gitlens.cloudPatches.enabled"

package.json

@@ -7879,7 +7879,8 @@
 			{
 				"command": "gitlens.plus.cloudIntegrations.manage",
 				"title": "Manage Integrations...",
-				"category": "GitLens"
+				"category": "GitLens",
+				"icon": "$(plug)"
 			},
 			{
 				"command": "gitlens.plus.hide",
@@ -8162,6 +8163,12 @@
 				"title": "Show Line History View",
 				"category": "GitLens"
 			},
+			{
+				"command": "gitlens.showOutputChannel",
+				"title": "Show Output Channel",
+				"category": "GitLens",
+				"icon": "$(output)"
+			},
 			{
 				"command": "gitlens.showPatchDetailsPage",
 				"title": "Show Patch Details",
@@ -13022,6 +13029,10 @@
 					"command": "gitlens.showLineHistoryView",
 					"when": "gitlens:enabled && !gitlens:hasVirtualFolders"
 				},
+				{
+					"command": "gitlens.showOutputChannel",
+					"when": "gitlens:enabled"
+				},
 				{
 					"command": "gitlens.showPatchDetailsPage",
 					"when": "gitlens:enabled && gitlens:gk:organization:drafts:enabled && config.gitlens.cloudPatches.enabled"
@@ -19564,6 +19575,16 @@
 					"group": "5_gitlens_open@2",
 					"alt": "gitlens.copyRemoteFileUrlWithoutRange"
 				},
+				{
+					"command": "gitlens.showOutputChannel",
+					"when": "viewItem =~ /gitlens:launchpad:error/",
+					"group": "inline@2"
+				},
+				{
+					"command": "gitlens.plus.cloudIntegrations.manage",
+					"when": "viewItem =~ /gitlens:launchpad:error\\+auth/",
+					"group": "inline@1"
+				},
 				{
 					"command": "gitlens.views.openPullRequestChanges",
 					"when": "viewItem =~ /gitlens:(pullrequest\\b(?=.*?\\b\\+refs\\b)|launchpad:item\\b(?=.*?\\b\\+pr\\b))/",

src/commands.ts

@@ -34,6 +34,7 @@ import './commands/ghpr/openOrCreateWorktree';
 import './commands/gitWizard';
 import './commands/inviteToLiveShare';
 import './commands/inspect';
+import './commands/showOutputChannel';
 import './commands/logging';
 import './commands/openAssociatedPullRequestOnRemote';
 import './commands/openBranchesOnRemote';

src/commands/showOutputChannel.ts

@@ -0,0 +1,14 @@
+import { command } from '../system/-webview/command';
+import { Logger } from '../system/logger';
+import { GlCommandBase } from './commandBase';
+
+@command()
+export class ShowOutputChannelCommand extends GlCommandBase {
+	constructor() {
+		super('gitlens.showOutputChannel');
+	}
+
+	execute(): void {
+		Logger.showOutputChannel();
+	}
+}

src/constants.commands.generated.ts

@@ -246,6 +246,7 @@ export type ContributedCommands =
 	| 'gitlens.openRevisionFile:editor/title'
 	| 'gitlens.openWorkingFile:editor/context'
 	| 'gitlens.openWorkingFile:editor/title'
+	| 'gitlens.plus.cloudIntegrations.manage'
 	| 'gitlens.plus.login'
 	| 'gitlens.pullRepositories'
 	| 'gitlens.pushRepositories'
@@ -274,6 +275,7 @@ export type ContributedCommands =
 	| 'gitlens.showInDetailsView'
 	| 'gitlens.showLineCommitInView'
 	| 'gitlens.showLineHistoryView'
+	| 'gitlens.showOutputChannel'
 	| 'gitlens.showQuickCommitFileDetails'
 	| 'gitlens.showQuickRevisionDetails:editor'
 	| 'gitlens.showQuickRevisionDetails:editor/title'
@@ -981,6 +983,7 @@ export type ContributedPaletteCommands =
 	| 'gitlens.showLaunchpadView'
 	| 'gitlens.showLineCommitInView'
 	| 'gitlens.showLineHistoryView'
+	| 'gitlens.showOutputChannel'
 	| 'gitlens.showPatchDetailsPage'
 	| 'gitlens.showQuickBranchHistory'
 	| 'gitlens.showQuickCommitDetails'

src/views/launchpadView.ts

@@ -1,10 +1,10 @@
 import type { ConfigurationChangeEvent, TreeViewVisibilityChangeEvent } from 'vscode';
-import { Disposable, ThemeIcon, TreeItem, TreeItemCollapsibleState, Uri, window } from 'vscode';
+import { Disposable, ThemeColor, ThemeIcon, TreeItem, TreeItemCollapsibleState, Uri, window } from 'vscode';
 import type { OpenWalkthroughCommandArgs } from '../commands/walkthroughs';
 import type { LaunchpadViewConfig, ViewFilesLayout } from '../config';
 import { proBadge } from '../constants';
 import type { Container } from '../container';
-import { AuthenticationRequiredError } from '../errors';
+import { AuthenticationError, AuthenticationRequiredError } from '../errors';
 import { GitUri, unknownGitUri } from '../git/gitUri';
 import type { PullRequest } from '../git/models/pullRequest';
 import type { SubscriptionChangeEvent } from '../plus/gk/subscriptionService';
@@ -16,9 +16,11 @@ import type { LaunchpadGroup } from '../plus/launchpad/models/launchpad';
 import { launchpadGroupIconMap, launchpadGroupLabelMap } from '../plus/launchpad/models/launchpad';
 import { createCommand, executeCommand } from '../system/-webview/command';
 import { configuration } from '../system/-webview/configuration';
+import { AggregateError } from '../system/promise';
 import { CacheableChildrenViewNode } from './nodes/abstract/cacheableChildrenViewNode';
 import type { ClipboardType, ViewNode } from './nodes/abstract/viewNode';
 import { ContextValues, getViewNodeId } from './nodes/abstract/viewNode';
+import { MessageNode } from './nodes/common';
 import type { GroupingNode } from './nodes/groupingNode';
 import { LaunchpadViewGroupingNode } from './nodes/launchpadViewGroupingNode';
 import { getPullRequestChildren, getPullRequestTooltip } from './nodes/pullRequestNode';
@@ -121,7 +123,7 @@ export class LaunchpadItemNode extends CacheableChildrenViewNode<'launchpad-item
 export class LaunchpadViewNode extends CacheableChildrenViewNode<
 	'launchpad',
 	LaunchpadView,
-	GroupingNode | LaunchpadItemNode
+	GroupingNode | LaunchpadItemNode | MessageNode
 > {
 	private disposable: Disposable;
 
@@ -151,7 +153,31 @@ export class LaunchpadViewNode extends CacheableChildrenViewNode<
 		this.children = undefined;
 	}
 
-	async getChildren(): Promise<(GroupingNode | LaunchpadItemNode)[]> {
+	private createErrorNode(error: Error): MessageNode {
+		// Extract AuthenticationError from AggregateError if present
+		let actualError = error;
+		if (error instanceof AggregateError) {
+			const firstAuthError = error.errors.find(e => e instanceof AuthenticationError);
+			actualError = firstAuthError ?? error.errors[0] ?? error;
+		}
+
+		const isAuthError = actualError instanceof AuthenticationError;
+		const contextValue = isAuthError ? ContextValues.LaunchpadErrorAuth : ContextValues.LaunchpadError;
+
+		return new MessageNode(
+			this.view,
+			this,
+			isAuthError ? 'Authentication Required' : 'Unable to fully load items',
+			actualError.name === 'HttpError' && 'status' in actualError && typeof actualError.status === 'number'
+				? `${actualError.status}: ${String(actualError)}`
+				: String(actualError),
+			String(actualError),
+			new ThemeIcon('warning', new ThemeColor('list.warningForeground')),
+			contextValue,
+		);
+	}
+
+	async getChildren(): Promise<(GroupingNode | LaunchpadItemNode | MessageNode)[]> {
 		this.view.description = this.view.grouped
 			? `${this.view.name.toLocaleLowerCase()}\u00a0\u2022\u00a0 ${proBadge}`
 			: proBadge;
@@ -161,13 +187,25 @@ export class LaunchpadViewNode extends CacheableChildrenViewNode<
 			const access = await this.view.container.git.access('launchpad');
 			if (!access.allowed) return [];
 
-			const children: (GroupingNode | LaunchpadItemNode)[] = [];
+			const children: (GroupingNode | LaunchpadItemNode | MessageNode)[] = [];
 
 			const hasIntegrations = await this.view.container.launchpad.hasConnectedIntegration();
 			if (!hasIntegrations) return [];
 
 			try {
 				const result = await this.view.container.launchpad.getCategorizedItems();
+
+				// Handle error - always show error node
+				if (result.error != null) {
+					this.view.message = undefined;
+					children.push(this.createErrorNode(result.error));
+
+					// If there are no items, just return the error node
+					if (!result.items?.length) {
+						return children;
+					}
+				}
+
 				if (!result.items?.length) {
 					this.view.message = 'All done! Take a vacation.';
 					return [];

src/views/nodes/abstract/viewNode.ts

@@ -67,6 +67,8 @@ export const enum ContextValues {
 	FileHistory = 'gitlens:history:file',
 	Folder = 'gitlens:folder',
 	Grouping = 'gitlens:grouping',
+	LaunchpadError = 'gitlens:launchpad:error',
+	LaunchpadErrorAuth = 'gitlens:launchpad:error+auth',
 	LaunchpadItem = 'gitlens:launchpad:item',
 	LineHistory = 'gitlens:history:line',
 	MergeConflictCurrentChanges = 'gitlens:merge-conflict:current',