refactor: remove StackTreeDataProvider and implement StackWebViewProvider

- Deleted StackTreeDataProvider.ts to streamline stack management.
- Introduced StackWebViewProvider.ts to handle rendering of the current branch's PR stack.
- Added webview HTML generation and state management for the stack view.
- Implemented React components for stack display, including StackList, StackRow, and StackTargetChip.
- Created context menu for stack actions and integrated logging for user interactions.
- Updated TypeScript configuration and Webpack setup to include new stack-related components.

Author: Test

.claude/rules/architecture.md

@@ -26,9 +26,13 @@ Business logic decoupled from VS Code UI:
 - `JiraService` — fetches Jira issue data via REST API using stored token
 - `RefDetailsCache` — caches ref→commit lookups to avoid redundant git calls
 - `PRReviewWorktreeStore` — persists active PR-review worktree paths across sessions
-- `StackStore` — Memento wrapper over `context.workspaceState` persisting the detected stack forest (`{ branch, parent, source }`); manual entries always win over `github`/`heuristic` detection on merge (`mergeStackEntries`)
-- `stackDetectionService` — detects chains of dependent branches ("stacks") from two sources, merged: GitHub PR base chains (authoritative, via `GitHubClient.listOpenPullRequests`) and a local ancestry heuristic (`git merge-base --is-ancestor` / `git rev-list --count`, offline fallback). Pure functions (`computeLocalAncestryParents`, `computeGithubParents`, `mergeDetectedParents`) are unit-tested against fixtures; `detectStacks` is the async orchestrator
-- `stackTopology` — pure forest/tree helpers (`buildStackForest`, `topoOrder`, `findStackContaining`) shared by `StackTreeDataProvider` and the status bar indicator
+- `StackStore` — Memento wrapper over `context.workspaceState`; now scoped to the local-ancestry **fallback** path only (`{ branch, parent, source: 'heuristic' | 'manual' }`), plus manual overrides (`mergeStackEntries`). PR-derived stacks are never persisted as edges here — see `prStack`/`stackModel` below
+- `stackDetectionService` — the local ancestry heuristic (`computeLocalAncestryParents`, `detectLocalAncestryStacks` via `git merge-base --is-ancestor` / `git rev-list --count`, `heuristicEntriesFrom`). Offline-only; consulted by `StackService` solely as a fallback, never merged with PR data
+- `stackTopology` — pure forest/tree helpers (`buildStackForest`, `topoOrder`, `findStackContaining`) used by the heuristic fallback path
+- `prStack` — pure PR-chain walker: `buildPrStack(prs, currentBranch, { trunk })` walks `head -> base` links both directions from the current branch and returns the ordered chain plus the target branch (which may be trunk or any other branch); no `localBranches` filter, so remote-only chain members and chains targeting trunk are both valid
+- `stackModel` — the `StackView` shape both the Stacks webview and the status bar render (`stackViewFromPrStack` / `stackViewFromForest`, `indicatorBranchesOf`, `stackInfoMapOf`)
+- `PrStackCache` — Memento-backed cache of the raw open-PR list per repository (TTL-based `isPrCacheFresh`), so a refresh fetches PRs at most once and a stale/offline fetch can still render from the last known list
+- `StackService` — orchestrates a refresh: GitHub PR chains are authoritative and fetched once (`GitHubClient.listOpenPullRequestsOrThrow`); the heuristic only runs when GitHub data is genuinely unusable (no remote, or the API call failed with no fresh cache) — the two sources are structurally never merged into one view
 
 ## Git Integration (`src/common/git/`)
 
@@ -48,20 +52,21 @@ Two distinct abstractions — don't conflate them:
 | `autoStashAndPop` | Stash is popped onto target branch (destructive) |
 | `autoStashAndApply` | Stash applied to target branch, original preserved |
 
-## Stacks Tree View & Status Bar Indicator
+## Stacks View & Status Bar Indicator
 
-`StackTreeDataProvider` (`src/view/`, view id `git-smart-checkout.stacks`, same activity-bar container as Worktrees) follows the two-phase render pattern from `WorktreeTreeDataProvider`: fast phase 1 builds the forest topology from `StackStore` alone, phase 2 asynchronously enriches each branch with PR number/state, ahead/behind vs. parent, and a needs-restack flag (`NOT git merge-base --is-ancestor <parent-tip> <branch-tip>`). Detection itself is driven externally from `extension.ts` (`refreshStacks`, debounced on git state/config changes), not by the provider.
+`StackWebViewProvider` (`src/view/`, view id `git-smart-checkout.stacks`, same activity-bar container as Worktrees) renders **only the stack containing the current branch** — data is pushed in via `setStack(view)`, the provider itself has no git/GitHub access. Detection is driven externally from `extension.ts` (`refreshStacks`, debounced on git state/config changes) via `StackService.refresh()`, which fetches the open-PR list **once** per refresh (shared by the webview and the status bar), unlike the tree-view era which fetched per branch.
 
-`StatusBarManager` owns a second status bar item (priority = mode item's priority + 1, so it renders immediately to its left) showing `$(layers) <position>/<size>` for the current branch's stack, gated by `shouldShowStackIndicator` (pure, unit-tested) — hidden when stacks are disabled, the status bar is off, HEAD is detached, or the branch isn't stacked.
+`StatusBarManager` owns a second status bar item (priority = mode item's priority + 1, so it renders immediately to its left) showing `$(layers) <position>/<size>` for the current branch's stack (`<size>` counts stacked PRs/branches only — the target is excluded, so sitting on the target itself shows no position), gated by `shouldShowStackIndicator` (pure, unit-tested) — hidden when stacks are disabled, the status bar is off, HEAD is detached (`isDetached` is a real signal from `StackService`, not derived from data presence), or the branch isn't stacked.
 
 ## WebView Integration
 
-Two React-based webviews in `src/view/` (providers) + `src/webview/Apps/` (React roots):
+Three React-based webviews in `src/view/` (providers) + `src/webview/Apps/` (React roots):
 
 - **PR Clone** (`PrCloneWebViewProvider` → `Apps/PR/`) — form: target branch, feature branch name, description with Markdown preview, Create/Cancel
 - **PR Commits** (`PrCommitsWebViewProvider` → `Apps/Commits/`) — commit list with per-commit selection for cherry-pick
+- **Stacks** (`StackWebViewProvider` → `Apps/Stacks/`) — the current branch's PR stack (`StackList`/`StackRow`/`StackTargetChip`/`ContextMenu` components); click a row to check it out via `git-smart-checkout.checkoutBranch` (argument-only, not palette-visible — reuses `AutoStashService` through the shared `checkoutRefWithStash` tail), right-click for "Open PR in Browser". The target chip additionally shows a read-only `⇡N ⇣N` ahead/behind indicator (`StackView.targetAheadBehind`, sourced from `%(upstream:track)` the same way `WorktreeTreeDataProvider` does) and a "Fetch latest changes" icon button that runs `git-smart-checkout.fetchBranch` (argument-only; `GitExecutor.fetchSpecificBranch`) then re-refreshes
 
-Webpack builds separate bundles (`main.js`, `commits.js`) via `webpack.webview.config.js`. WebView↔extension communication uses `postMessage` / `onDidReceiveMessage`. VS Code CSS variables handle theming.
+`src/view/webviewHtml.ts` (`buildWebviewHtml`) is the single place that rewrites a built webview's HTML for use in a `WebviewView`: asset URIs, script nonce, and CSP injection — shared by all three providers. Webpack builds separate bundles (`main.js`, `commits.js`, `stacks.js`) via `webpack.webview.config.js`. WebView↔extension communication uses `postMessage` / `onDidReceiveMessage`. VS Code CSS variables handle theming.
 
 ### Markdown Preview
 

.gitignore

@@ -24,6 +24,7 @@ settings.local.json
 .claude/skills/
 changed-files.jsonl
 plans/
+.claude/
 
 # .agents
 .agents

README.md

@@ -40,7 +40,7 @@ All commands are grouped under the `GSC:` prefix in the Command Palette.
 | Open a terminal in a selected worktree's directory | `GSC: Open Worktree Dev Terminal...` | [Open worktree dev terminal](docs/open-worktree-dev-terminal.md) |
 | Remove several Git worktrees at once with a single confirmation | `GSC: Remove Multiple Worktrees...` | [Remove multiple worktrees](docs/remove-multiple-worktrees.md) |
 | Browse all worktrees for the open repositories in a dedicated "Worktrees" view (activity bar), with dirty/ahead-behind/PR-review status and inline Open/Terminal/Copy WIP/Remove actions | *(tree view — right-click an item for Add to Workspace, Copy Path, Reveal in Finder/Explorer)* | — |
-| Detect chains of dependent local branches ("stacks") from GitHub PR base chains and/or local ancestry, and browse them in a dedicated "Stacks" view (activity bar) with PR number, ahead/behind, and needs-restack status per branch. A status bar indicator (`$(layers) <position>/<size>`) shows where the current branch sits in its stack; click it to reveal the Stacks view. | *(tree view — passive, zero-config)* | — |
+| Detect the chain of open GitHub PRs the current branch belongs to (a "stack"), and browse it in a dedicated "Stacks" view (activity bar) showing each PR's title and branch plus the branch the stack is ultimately targeting. Click a row (or its target chip) to check it out using the currently selected checkout/stash strategy; right-click for "Open PR in Browser". Falls back to a local-ancestry heuristic when there's no GitHub remote. A status bar indicator (`$(layers) <position>/<size>`) appears only while the current branch is part of a stack; click it to reveal the Stacks view. | `GSC: Refresh Stacks` | [Stacks](docs/stacks.md) |
 | Create a new PR from selected commits in another GitHub PR | `GSC: Clone Pull Request...` | [GitHub PR clone](docs/github-pr-clone.md) |
 | Generate and optionally push a tag from a reusable template | `GSC: Create Tag from Template...` | [Create tag from template](docs/create-tag-from-template.md) |
 | Create and check out a branch from a template (Jira, file, regex, scripts) | `GSC: Create Branch from Template...` | [Create branch from template](docs/create-branch-from-template.md) |
@@ -83,8 +83,8 @@ Click a setting ID to open that setting in VS Code.
 | ⚙️ [`git-smart-checkout.pushTagWithoutConfirmation`](vscode://settings/git-smart-checkout.pushTagWithoutConfirmation) (Push tag without confirmation) | `boolean` | Pushes the created Git tag to the remote without asking for confirmation. |
 | ⚙️ [`git-smart-checkout.tagRemote`](vscode://settings/git-smart-checkout.tagRemote) (Tag remote) | `string` | Git remote used when pushing created tags. |
 | ⚙️ [`git-smart-checkout.telemetry.enabled`](vscode://settings/git-smart-checkout.telemetry.enabled) (Telemetry enabled) | `boolean` | Enables anonymous Git Smart Checkout analytics while respecting VS Code's global telemetry settings. |
-| ⚙️ [`git-smart-checkout.stacks.enabled`](vscode://settings/git-smart-checkout.stacks.enabled) (Stacks enabled) | `boolean` | Detects and visualizes stacks of dependent branches (Stacks view and status bar indicator). Default `true`. |
-| ⚙️ [`git-smart-checkout.stacks.detection`](vscode://settings/git-smart-checkout.stacks.detection) (Stacks detection mode) | `string` | How stacks are detected. Available values: `auto` (default; GitHub PR base chains, falling back to the local ancestry heuristic), `github` (PR base chains only), `local` (local ancestry heuristic only, no GitHub API calls), `manual` (no automatic detection). |
+| ⚙️ [`git-smart-checkout.stacks.enabled`](vscode://settings/git-smart-checkout.stacks.enabled) (Stacks enabled) | `boolean` | Detects and visualizes the current branch's PR stack (Stacks view and status bar indicator). Default `true`. |
+| ⚙️ [`git-smart-checkout.stacks.detection`](vscode://settings/git-smart-checkout.stacks.detection) (Stacks detection mode) | `string` | How stacks are detected. Available values: `auto` (default; GitHub PR chains, falling back to the local ancestry heuristic only when GitHub data is unavailable), `github` (PR chains only, no heuristic fallback), `local` (local ancestry heuristic only, no GitHub API calls), `manual` (no automatic detection). |
 
 ## Telemetry
 

docs/stacks.md

@@ -0,0 +1,54 @@
+# Stacks
+
+Command: `Git Smart Checkout: Refresh Stacks`
+
+Detects the chain of open GitHub pull requests the current branch belongs to (a "stack") and shows it in the "Stacks" view (Git Smart Checkout activity bar container), alongside a status bar indicator.
+
+## What Counts as a Stack
+
+A stack is a chain of open PRs linked `head -> base`, ending at a **target** branch that has no open PR of its own (often `main`, but it can be any branch — a release branch, another feature branch, etc.). For example:
+
+```
+PR #52  vradchuk/feature-1-for-release-v1.1   (head -> base: test/feature-1-for-release-v1)
+PR #12  test/feature-1-for-release-v1          (head -> base: test/fake-release-v1)
+        test/fake-release-v1                   <- target (no open PR)
+```
+
+Rules:
+
+- A single PR onto the default branch (trunk) is **not** a stack — that's just an ordinary PR.
+- A single PR onto any other branch **is** a stack (the target chip is the point).
+- Sitting on trunk itself never shows a stack.
+- If a branch is the base of more than one open PR (a fork in the stack), the PR with the lowest number is followed; the others aren't shown.
+
+## The Stacks View
+
+Shows the stack containing the **current branch**, top PR first, target branch as a chip at the bottom. Each row shows the PR title and `#number · branch`; the current branch/target is highlighted.
+
+- **Click a row (or the target chip)** to check out that branch, using whichever [stash mode](switch-mode.md) is currently active — including the manual prompt if that's what's configured.
+- **Right-click a row** (or use the inline external-link icon) for "Open PR in Browser".
+- The target chip shows **⇡N ⇣N** (commits waiting to be pushed / commits to pull), read directly from the branch's upstream tracking info — the same convention as the Worktrees view — whenever the target branch has an upstream configured. Next to it, a **fetch icon (⟳, "Fetch latest changes")** fetches the target branch from its remote (updating the remote-tracking ref only, no checkout, no merge) and refreshes the indicator.
+- When the current branch isn't part of any stack, the view shows an empty state with a Refresh button.
+
+## Status Bar Indicator
+
+`$(layers) <position>/<size>` appears immediately to the left of the stash-mode item, but **only** while the current branch is part of a detected stack — it's hidden when stacks are disabled, the extension's status bar is off, HEAD is detached, or the branch simply isn't stacked. The count is of **stacked PRs (or heuristic branches) only** — the target branch doesn't count toward `<size>`, so sitting on the target itself shows no position (there's no PR there). Its tooltip lists the chain top-to-bottom with PR numbers/titles, plus the target branch on its own line. Click it to reveal the Stacks view.
+
+## Detection Sources
+
+Controlled by `git-smart-checkout.stacks.detection`:
+
+| Value | Behavior |
+| --- | --- |
+| `auto` (default) | GitHub PR chains; falls back to the local ancestry heuristic only when GitHub data is genuinely unavailable (no GitHub remote/token, or the API call fails with no usable cache). |
+| `github` | GitHub PR chains only — no heuristic fallback. |
+| `local` | Local ancestry heuristic only (no GitHub API calls); useful offline or without a GitHub remote. |
+| `manual` | No automatic detection. |
+
+GitHub PR chains are **authoritative** — the two sources are never merged into one stack. The heuristic (closest ancestor branch by commit distance) is a fallback for when there's no usable PR data at all, so it never grafts extra branches onto a genuine PR stack.
+
+Disable everything with:
+
+```json
+"git-smart-checkout.stacks.enabled": false
+```

package.json

@@ -59,7 +59,7 @@
         {
           "id": "git-smart-checkout.stacks",
           "name": "Stacks",
-          "type": "tree",
+          "type": "webview",
           "icon": "$(layers)",
           "when": "git-smart-checkout.hasRepository"
         },
@@ -90,6 +90,12 @@
         "title": "Checkout Previous Branch (With Stash)",
         "category": "GSC"
       },
+      {
+        "command": "git-smart-checkout.stacks.refresh",
+        "title": "Refresh Stacks",
+        "category": "GSC",
+        "icon": "$(refresh)"
+      },
       {
         "command": "git-smart-checkout.copyBranchName",
         "title": "Copy Current Branch Name to Clipboard",
@@ -349,6 +355,11 @@
           "when": "view == git-smart-checkout.worktrees",
           "group": "navigation@3"
         },
+        {
+          "command": "git-smart-checkout.stacks.refresh",
+          "when": "view == git-smart-checkout.stacks",
+          "group": "navigation@1"
+        },
         {
           "command": "git-smart-checkout.prCancelCloneMenu",
           "when": "view == git-smart-checkout.prClone && git-smart-checkout.isCloning == true && git-smart-checkout.isConflict == true",
@@ -690,7 +701,7 @@
         "git-smart-checkout.stacks.enabled": {
           "type": "boolean",
           "default": true,
-          "description": "Detect and visualize stacks of dependent branches (Stacks tree view and status bar indicator)."
+          "description": "Detect and visualize the current branch's PR stack (Stacks view and status bar indicator)."
         },
         "git-smart-checkout.stacks.detection": {
           "type": "string",
@@ -701,8 +712,8 @@
             "manual"
           ],
           "markdownEnumDescriptions": [
-            "Use GitHub PR base chains when available, falling back to the local ancestry heuristic",
-            "Only use GitHub PR base chains",
+            "Use GitHub PR chains when available, falling back to the local ancestry heuristic only when GitHub data is unavailable",
+            "Only use GitHub PR chains (no heuristic fallback)",
             "Only use the local ancestry heuristic (no GitHub API calls)",
             "Disable automatic detection; rely entirely on manually-set stack parents"
           ],

src/analytics/analytics.ts

@@ -36,6 +36,8 @@ export enum AnalyticsEvent {
   BranchStashRestored = 'branch_stash_restored',
   StatusBarMenuOpened = 'status_bar_menu_opened',
   SettingsOpened = 'settings_opened',
+  CheckoutStackBranch = 'checkout_stack_branch',
+  FetchStackBaseBranch = 'fetch_stack_base_branch',
 }
 
 let client: PostHog | null = null;