Skip to content

Add Graph walkthrough as separate state in Welcome view#5240

Open
sergeibbb wants to merge 2 commits into
mainfrom
5149-approach-b-separate-state
Open

Add Graph walkthrough as separate state in Welcome view#5240
sergeibbb wants to merge 2 commits into
mainfrom
5149-approach-b-separate-state

Conversation

@sergeibbb
Copy link
Copy Markdown
Member

@sergeibbb sergeibbb commented May 15, 2026

Summary

  • Adds a dedicated Graph walkthrough flow with 6 steps (agent monitoring, parallel work, AI review, compose, compare, next steps) as a separate mode in the Welcome view
  • Implements independent progress tracking for the Graph walkthrough via WalkthroughStateProvider
  • Adds a "What's new in GitLens 18" banner in the Graph header to drive discovery
  • Fixes back-link color specificity so "Back to the GitLens walkthrough" renders in gray per design

Closes #5149
Ref: #5149 (comment)

Test plan

  • Open the Welcome view — verify the main walkthrough renders normally with progress tracking
  • Open the Commit Graph — verify "What's new in GitLens 18" banner appears in the header
  • Click the banner — verify Welcome view switches to Graph walkthrough mode
  • Verify "Back to the GitLens walkthrough" link is gray (not blue link color)
  • Click "Back to the GitLens walkthrough" — verify it returns to main walkthrough
  • Complete Graph walkthrough steps and verify progress tracking works independently
  • Test in light, dark, and high-contrast themes

@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from 93a3feb to dc7f30d Compare May 19, 2026 13:06
sergeibbb added a commit that referenced this pull request May 19, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from dc7f30d to 2ce34cf Compare May 19, 2026 13:07
sergeibbb added a commit that referenced this pull request May 19, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from 2ce34cf to a20b82c Compare May 19, 2026 14:24
sergeibbb added a commit that referenced this pull request May 19, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from a20b82c to 3963c5a Compare May 19, 2026 15:03
sergeibbb added a commit that referenced this pull request May 19, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from 3963c5a to d06c270 Compare May 19, 2026 16:04
sergeibbb added a commit that referenced this pull request May 20, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch 2 times, most recently from 604a728 to d9d8693 Compare May 20, 2026 15:05
sergeibbb added a commit that referenced this pull request May 20, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
sergeibbb added a commit that referenced this pull request May 20, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch 2 times, most recently from d67f39f to 2aedd0c Compare May 20, 2026 22:25
sergeibbb added a commit that referenced this pull request May 20, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from 2aedd0c to bcde25e Compare May 20, 2026 22:45
sergeibbb added a commit that referenced this pull request May 20, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
sergeibbb added a commit that referenced this pull request May 20, 2026
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from bcde25e to 04c9b53 Compare May 20, 2026 23:44
sergeibbb added a commit that referenced this pull request May 20, 2026
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from 04c9b53 to 6e1d916 Compare May 20, 2026 23:58
sergeibbb added a commit that referenced this pull request May 20, 2026
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from 6e1d916 to a0d6f7a Compare May 20, 2026 23:59
sergeibbb added a commit that referenced this pull request May 21, 2026
- preventing double invocation of the popover dismissing
(#5149, #5240)
- Introduces a dismissible banner in the Graph header to highlight new
features and guide users through the updated Commit Graph
- Adds a new "graph" mode to the welcome view with dedicated walkthrough
progress tracking for Graph-specific features (agent monitoring,
parallel work, AI review, compose, compare, next steps)
- Implements onboarding state management for the Graph walkthrough
banner with persistence across sessions
- Extends telemetry and context tracking to support Graph walkthrough
completion events
- Adds back navigation link styling in the welcome view for improved
navigation between main and graph walkthroughs
- Updates welcome view to accept mode parameter and switch between main
and graph walkthroughs dynamically
(#5149, #5240)
sergeibbb added a commit that referenced this pull request May 21, 2026
- preventing double invocation of the popover dismissing
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from a94c10f to fdc7d3d Compare May 21, 2026 00:26
- preventing double invocation of the popover dismissing
(#5149, #5240)
@sergeibbb sergeibbb force-pushed the 5149-approach-b-separate-state branch from fdc7d3d to d9b9ef8 Compare May 21, 2026 00:34
@sergeibbb sergeibbb marked this pull request as ready for review May 21, 2026 00:37
@augmentcode
Copy link
Copy Markdown

augmentcode Bot commented May 21, 2026

🤖 Augment PR Summary

Summary: This PR adds a dedicated “What’s new in GitLens 18” Commit Graph walkthrough as a separate mode inside the Welcome view, with independent progress tracking.

Changes:

  • Introduces a new Graph walkthrough flow (6 steps) and a separate mode switch in the Welcome webview UI/state.
  • Extends walkthrough state tracking to include Graph-specific context keys and completion calculation.
  • Adds a “What’s new” banner/tooltip entry point in the Graph header and wires it to open the Welcome view in Graph mode.
  • Adds new Graph “show” arguments (sidebarPanel / action) and corresponding IPC notifications to drive webview behavior.
  • Emits usage tracking IPC commands for overview shown, scope changes, details panel mode changes, and WIP next-steps visibility.
  • Updates telemetry type definitions and documentation to include the new Graph walkthrough context keys and tracked actions.

Technical Notes: The Graph walkthrough completion is driven by new usage keys (tracked from the Graph webview) and surfaced to both the Graph webview state and the Welcome webview state.

🤖 Was this summary useful? React with 👍 or 👎

Copy link
Copy Markdown

@augmentcode augmentcode Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. 2 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.


this._pendingScopeToBranch = false;
const selected = this.graphState.repositories?.find(r => r.id === this.graphState.selectedRepository);
const repoPath = selected != null ? (selected.commonPath ?? selected.path) : this.fallbackRepoPath;
Copy link
Copy Markdown

@augmentcode augmentcode Bot May 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

scopeToBranch() prefers selected.commonPath over selected.path, but Graph ids/refs elsewhere appear to rely on repository.path (worktree workspaces can differ), so getBranchId() here may not match any rows/anchors and the scope-to-branch action could no-op.

Severity: medium

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

[
'graphCompose',
{
usage: ['action:gitlens.graph.details.composeMode:happened', 'action:gitlens.ai.generateCommits:happened'],
Copy link
Copy Markdown

@augmentcode augmentcode Bot May 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For graphCompose, including action:gitlens.ai.generateCommits:happened can complete the Graph walkthrough step from the standalone composer flow (not Graph), which would make Graph walkthrough progress/telemetry inaccurate.

Severity: medium

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

@sergeibbb sergeibbb requested a review from d13 May 21, 2026 00:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Introduce new feature on release in the Welcome view

2 participants