docs: release notes and changelog for v0.8.1

CHANGELOG.md

@@ -1,5 +1,32 @@
 # Change Log
 
+## 0.8.1
+
+### New Features
+
+- **Item Counts on Tree Nodes**: Database nodes now display a live collection count, and the Indexes folder shows an index count. Counts load asynchronously without blocking tree expansion. A new `documentDB.accessibility.hideCountPrefix` setting hides the `··` visual separator for accessibility or aesthetic preference. [#714](https://github.com/microsoft/vscode-documentdb/pull/714), [#658](https://github.com/microsoft/vscode-documentdb/issues/658), [#659](https://github.com/microsoft/vscode-documentdb/issues/659)
+- **AI Model Transparency in Query Insights**: Query Insights now discloses which model processed the request and confirms upfront that the utility model does not count against the GitHub Copilot premium request quota. A model attribution byline ("Powered by {model} via GitHub Copilot") appears after each successful analysis. [#690](https://github.com/microsoft/vscode-documentdb/pull/690)
+- **Batch Connection Deletion**: Multi-select connections in the Connections View and delete them all in one command. The confirmation message adapts to the count, deletion continues on individual failures, and a summary is reported on completion. [#667](https://github.com/microsoft/vscode-documentdb/pull/667)
+
+### Improvements
+
+- **Performance: Faster Connection Load and Startup**: Significant startup speedup, especially on Remote-WSL and large connection lists. Connections now load concurrently; a short-lived cache coalesces redundant reads; startup cleanup is gated to run once per version, not every launch. Also removes the legacy one-time Azure Databases extension connection import. **Note:** users who had un-imported connections in `ms-azuretools.vscode-cosmosdb` will need to re-add them manually. [#726](https://github.com/microsoft/vscode-documentdb/pull/726)
+- **Performance: Throttled Background Document-Count Fetches**: A per-cluster concurrency limiter now caps simultaneous background count requests at 5 with a 250 ms inter-task delay, preventing connection pool saturation when expanding databases with many collections. [#685](https://github.com/microsoft/vscode-documentdb/pull/685)
+- **Shard Key in Collection Tooltip**: Sharded collections now show their shard key in the hover tooltip. Extracted from the existing `listCollections()` response at no extra cost. [#670](https://github.com/microsoft/vscode-documentdb/pull/670), [#661](https://github.com/microsoft/vscode-documentdb/issues/661)
+- **Contextual Query Playground Filenames**: New playground files opened from the tree now use context-derived names (e.g., `cluster_collection.documentdb.js`) with invalid-character sanitization and numeric suffixes for duplicates. [#664](https://github.com/microsoft/vscode-documentdb/pull/664), [#660](https://github.com/microsoft/vscode-documentdb/issues/660)
+- **`_id_` Index Sorted First**: The `_id_` index now always appears at the top of the Indexes list regardless of other index names and locale sort order. [#662](https://github.com/microsoft/vscode-documentdb/pull/662), [#657](https://github.com/microsoft/vscode-documentdb/issues/657)
+- **`credentialId` → `clusterId` Parameter Rename**: Renamed the `credentialId` parameter to `clusterId` in `ClustersClient` and `ClusterSession` for naming consistency. Community contribution by [@CalvinMagezi](https://github.com/CalvinMagezi), [@Jah-yee](https://github.com/Jah-yee), and [@Enocko](https://github.com/Enocko). [#652](https://github.com/microsoft/vscode-documentdb/pull/652), [#567](https://github.com/microsoft/vscode-documentdb/issues/567)
+- **Hidden Index Tree Item**: Hidden indexes now show a `hidden` description label and only the appropriate context menu action (Hide or Unhide, not both). The `_id_` index shows neither action. [#674](https://github.com/microsoft/vscode-documentdb/pull/674), [#656](https://github.com/microsoft/vscode-documentdb/issues/656)
+- **Removed Obsolete Notification Migration Code**: Cleaned up pre-0.7.0 transitional release-notes logic and leftover `0.8.0-bugbash` migration paths. [#622](https://github.com/microsoft/vscode-documentdb/pull/622), [#611](https://github.com/microsoft/vscode-documentdb/issues/611)
+
+### Fixes
+
+- **Node 24 Compatibility**: VS Code 1.123 (released June 3, 2026) ships with Node 24, which broke extension loading. Updated `@microsoft/vscode-azext-utils` (~3.3.1 → ~4.1.0) and `@microsoft/vscode-azext-azureutils` (~3.4.5 → ~4.2.0) to restore compatibility. [#699](https://github.com/microsoft/vscode-documentdb/pull/699)
+
+### Dependencies
+
+- **Dependency Updates**: Updated `webpack-dev-server` (5.2.3 → 5.2.4, CORP security header fix), `@nevware21/ts-utils` (0.13.0 → 0.14.0 in root and `/api`), and `qs`/`express` to their latest versions. [#654](https://github.com/microsoft/vscode-documentdb/pull/654), [#672](https://github.com/microsoft/vscode-documentdb/pull/672), [#673](https://github.com/microsoft/vscode-documentdb/pull/673), [#678](https://github.com/microsoft/vscode-documentdb/pull/678)
+
 ## 0.8.0
 
 ### New Features

docs/index.md

@@ -77,7 +77,7 @@ The User Manual provides guidance on using DocumentDB for VS Code. It contains d
 
 Explore the history of updates and improvements to the DocumentDB for VS Code extension. Each release brings new features, enhancements, and fixes to improve your experience.
 
-- [0.8](./release-notes/0.8)
+- [0.8](./release-notes/0.8), [0.8.1](./release-notes/0.8#patch-release-v081)
 - [0.7](./release-notes/0.7), [0.7.2](./release-notes/0.7#patch-release-v072), [0.7.3](./release-notes/0.7#patch-release-v073), [0.7.4](./release-notes/0.7#patch-release-v074)
 - [0.6](./release-notes/0.6), [0.6.1](./release-notes/0.6#patch-release-v061), [0.6.2](./release-notes/0.6#patch-release-v062), [0.6.3](./release-notes/0.6#patch-release-v063)
 - [0.5](./release-notes/0.5), [0.5.1](./release-notes/0.5#patch-release-v051), [0.5.2](./release-notes/0.5#patch-release-v052)

docs/release-notes/0.8.md

@@ -130,3 +130,102 @@ The Collection View also supports **Paste**: paste a find expression from the cl
 
 See the full changelog entry for this release:
 ➡️ [CHANGELOG.md#080](https://github.com/microsoft/vscode-documentdb/blob/main/CHANGELOG.md#080)
+
+---
+
+## Patch Release v0.8.1
+
+This patch delivers Node 24 compatibility, significantly faster extension startup, tree view quality-of-life improvements with live item counts, AI transparency in Query Insights, batch connection deletion, and a fantastic wave of community contributions.
+
+### 🤲 Community Contributions
+
+This release would not be what it is without our fantastic open-source community. A big thank you to everyone who submitted pull requests, reported issues, and helped shape v0.8.1!
+
+- **[@lte-z](https://github.com/lte-z)** contributed two improvements in this release: hidden index visibility and context menu cleanup ([#674](https://github.com/microsoft/vscode-documentdb/pull/674)) and shard key display in collection tooltips ([#670](https://github.com/microsoft/vscode-documentdb/pull/670)).
+- **[@omribz156](https://github.com/omribz156)** added contextual filenames for new Query Playground files ([#664](https://github.com/microsoft/vscode-documentdb/pull/664)).
+- **[@Jacquelinezhong](https://github.com/Jacquelinezhong)** fixed the `_id_` index sort order so it always appears first in the Indexes list ([#662](https://github.com/microsoft/vscode-documentdb/pull/662)).
+- **[@Green00101](https://github.com/Green00101)** cleaned up the obsolete release-notes notification migration code ([#622](https://github.com/microsoft/vscode-documentdb/pull/622)).
+- **[@CalvinMagezi](https://github.com/CalvinMagezi)**, **[@Jah-yee](https://github.com/Jah-yee)**, and **[@Enocko](https://github.com/Enocko)** each independently submitted a fix for the `credentialId` → `clusterId` parameter rename ([#568](https://github.com/microsoft/vscode-documentdb/pull/568), [#575](https://github.com/microsoft/vscode-documentdb/pull/575), [#651](https://github.com/microsoft/vscode-documentdb/pull/651))! Three contributors tackling the same issue is a rare and wonderful thing. All of their work influenced the final merged result ([#652](https://github.com/microsoft/vscode-documentdb/pull/652)).
+
+### What's Changed in v0.8.1
+
+#### 💠 **Node 24 Compatibility** ([#699](https://github.com/microsoft/vscode-documentdb/pull/699))
+
+**VS Code 1.123** (released June 3, 2026) ships with Node 24. If you updated VS Code and found the DocumentDB extension no longer loading, this fix is for you. The extension now works correctly with VS Code 1.123 and later.
+
+#### 💠 **Item Counts on Tree Nodes** ([#714](https://github.com/microsoft/vscode-documentdb/pull/714))
+
+The tree view now tells you more before you click. Two new at-a-glance counts appear automatically as you browse:
+
+- **Collection count on database nodes:** After expanding a cluster, each database shows how many collections it contains (e.g., `·· 12`). For large clusters, counts cap at 50+ to keep the query lightweight.
+- **Index count on the Indexes folder:** Expanding a collection now shows how many indexes are present at a glance (e.g., `·· 4`).
+
+Counts load asynchronously in the background so tree expansion remains instant. A new `documentDB.accessibility.hideCountPrefix` setting lets you suppress the `··` visual separator for a cleaner look or better screen reader experience.
+
+#### 💠 **AI Model Transparency in Query Insights** ([#690](https://github.com/microsoft/vscode-documentdb/pull/690))
+
+Query Insights now tells you exactly which AI model analyzed your query and confirms upfront that the feature uses a **[utility model](https://aka.ms/vscode-documentdb-copilot-utility-model) that does not count against your GitHub Copilot premium request quota**. Both the pre-invocation card and the post-response panel now show:
+
+- A persistent _"No additional cost for most GitHub Copilot subscribers"_ disclosure with a **Learn more** link.
+- A _"Powered by {model} via GitHub Copilot"_ attribution byline after each successful analysis.
+
+> **What is a utility model?** Utility models are **included in all paid GitHub Copilot plans at no extra charge** (GPT-4o, GPT-4.1, and GPT-5 mini all carry a 0x request multiplier, meaning they do not consume your monthly premium request allowance). For the full breakdown by plan, see [AI Features: Utility Model and Pricing](https://aka.ms/vscode-documentdb-copilot-utility-model) in the user manual.
+
+#### 💠 **Batch Connection Deletion** ([#667](https://github.com/microsoft/vscode-documentdb/pull/667))
+
+You can now select multiple connections in the Connections View and delete them all at once. The command adapts its confirmation message to reflect the number of selected items, continues through individual failures so a single bad connection does not block the rest, and reports a summary when done. Clearing out stale connections from a long list just became much less tedious.
+
+#### 💠 **Faster Extension Startup and Connection Loading** ([#726](https://github.com/microsoft/vscode-documentdb/pull/726))
+
+The extension loads noticeably faster, with the biggest gains for users on **Remote-WSL** or anyone with a large number of saved connections. Your connections appear in the tree sooner after VS Code opens.
+
+> **Note:** This release removes the one-time import of connections from the legacy Azure Databases VS Code extension (`ms-azuretools.vscode-cosmosdb`). If you have connections in that extension that were never opened in DocumentDB for VS Code, you will need to re-add them manually using a connection string.
+
+#### 💠 **Performance: Throttled Background Document-Count Fetches** ([#685](https://github.com/microsoft/vscode-documentdb/pull/685))
+
+When a database with many collections is expanded, every collection fires a background document-count request. Previously, these all launched in parallel, potentially saturating the connection pool and competing with foreground queries. A new per-cluster concurrency limiter caps simultaneous count fetches at 5 and staggers them 250 ms apart, dramatically reducing server load while keeping the tree feeling responsive.
+
+#### 💠 **Hidden Index Visibility and Context Menu** ([#656](https://github.com/microsoft/vscode-documentdb/issues/656), [#674](https://github.com/microsoft/vscode-documentdb/pull/674))
+
+Hidden indexes are now clearly labeled in the tree view with a `hidden` description, and the right-click context menu has been tightened so only valid actions appear: hidden indexes show only **Unhide Index…**, non-hidden indexes show only **Hide Index…**, and the `_id_` index shows neither. No more guessing which action applies.
+
+> ⭐ Thanks to **[@lte-z](https://github.com/lte-z)** for this contribution!
+
+#### 💠 **Shard Key in Collection Tooltip** ([#661](https://github.com/microsoft/vscode-documentdb/issues/661), [#670](https://github.com/microsoft/vscode-documentdb/pull/670))
+
+Sharded collections now expose their shard key in the hover tooltip alongside document count and storage size. The information is extracted directly from the `listCollections()` response with no extra round-trips, and is only shown when a shard key is actually present; unsharded collections are unaffected.
+
+> ⭐ Thanks to **[@lte-z](https://github.com/lte-z)** for this contribution!
+
+#### 💠 **Contextual Query Playground Filenames** ([#660](https://github.com/microsoft/vscode-documentdb/issues/660), [#664](https://github.com/microsoft/vscode-documentdb/pull/664))
+
+New Query Playground files opened from the tree now get meaningful names derived from their context — for example, `myCluster_myCollection.documentdb.js` instead of a generic untitled name. Invalid filename characters are stripped automatically, and a numeric suffix is appended if the same name is already open.
+
+> ⭐ Thanks to **[@omribz156](https://github.com/omribz156)** for this contribution!
+
+#### 💠 **`_id_` Index Always Sorted First** ([#657](https://github.com/microsoft/vscode-documentdb/issues/657), [#662](https://github.com/microsoft/vscode-documentdb/pull/662))
+
+The `_id_` index — present on every collection — now always appears at the top of the Indexes list regardless of other index names. Previously, indexes with uppercase-leading names could sort above `_id_` due to locale comparison rules.
+
+> ⭐ Thanks to **[@Jacquelinezhong](https://github.com/Jacquelinezhong)** for this contribution!
+
+#### 💠 **Community Code Quality: `credentialId` → `clusterId` Rename** ([#567](https://github.com/microsoft/vscode-documentdb/issues/567), [#652](https://github.com/microsoft/vscode-documentdb/pull/652))
+
+The internal `credentialId` parameter in `ClustersClient` and `ClusterSession` has been renamed to `clusterId` to match the established naming convention throughout the codebase. This was a popular community contribution — three contributors submitted independent PRs for the same issue, and all of their work informed the final result.
+
+> ⭐ Thanks to **[@CalvinMagezi](https://github.com/CalvinMagezi)** ([#568](https://github.com/microsoft/vscode-documentdb/pull/568)), **[@Jah-yee](https://github.com/Jah-yee)** ([#575](https://github.com/microsoft/vscode-documentdb/pull/575)), and **[@Enocko](https://github.com/Enocko)** ([#651](https://github.com/microsoft/vscode-documentdb/pull/651)) for independently contributing to this fix!
+
+#### 💠 **Removed Obsolete Notification Migration Code** ([#611](https://github.com/microsoft/vscode-documentdb/issues/611), [#622](https://github.com/microsoft/vscode-documentdb/pull/622))
+
+Pre-0.7.0 transitional release-notes notification logic and a leftover `0.8.0-bugbash` migration path have been cleaned out, simplifying the notification system.
+
+> ⭐ Thanks to **[@Green00101](https://github.com/Green00101)** for this contribution!
+
+#### 💠 **Dependency Updates** ([#654](https://github.com/microsoft/vscode-documentdb/pull/654), [#672](https://github.com/microsoft/vscode-documentdb/pull/672), [#673](https://github.com/microsoft/vscode-documentdb/pull/673), [#678](https://github.com/microsoft/vscode-documentdb/pull/678))
+
+Updated `webpack-dev-server` (5.2.3 → 5.2.4, includes a CORP security header fix), `@nevware21/ts-utils` (0.13.0 → 0.14.0), and `qs`/`express` to their latest versions.
+
+### Changelog
+
+See the full changelog entry for this release:
+➡️ [CHANGELOG.md#081](https://github.com/microsoft/vscode-documentdb/blob/main/CHANGELOG.md#081)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "vscode-documentdb",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "releaseNotesUrl": "https://github.com/microsoft/vscode-documentdb/discussions/633",
   "aiKey": "0c6ae279ed8443289764825290e4f9e2-1a736e7c-1324-4338-be46-fc2a58ae4d14-7255",
   "publisher": "ms-azuretools",