bc-telemetry-buddy-mcp 1.0.0 → 2.0.0

package/$null

@@ -1,2 +1,2 @@
-'chmod' is not recognized as an internal or external command,
-operable program or batch file.
+'chmod' is not recognized as an internal or external command,
+operable program or batch file.

package/.bctb-config.json

@@ -1,28 +1,28 @@
-{
-  "profiles": {
-    "default": {
-      "connectionName": "My BC Production",
-      "authFlow": "azure_cli",
-      "applicationInsightsAppId": "your-app-insights-id",
-      "kustoClusterUrl": "https://ade.applicationinsights.io",
-      "workspacePath": "C:\\_Source\\Community\\waldo.BCTelemetryBuddy\\packages\\mcp",
-      "queriesFolder": "queries"
-    }
-  },
-  "defaultProfile": "default",
-  "cache": {
-    "enabled": true,
-    "ttlSeconds": 3600
-  },
-  "sanitize": {
-    "removePII": false
-  },
-  "references": [
-    {
-      "name": "Microsoft BC Telemetry Samples",
-      "type": "github",
-      "url": "https://github.com/microsoft/BCTech",
-      "enabled": true
-    }
-  ]
+{
+  "profiles": {
+    "default": {
+      "connectionName": "My BC Production",
+      "authFlow": "azure_cli",
+      "applicationInsightsAppId": "your-app-insights-id",
+      "kustoClusterUrl": "https://ade.applicationinsights.io",
+      "workspacePath": "C:\\_Source\\Community\\waldo.BCTelemetryBuddy\\packages\\mcp",
+      "queriesFolder": "queries"
+    }
+  },
+  "defaultProfile": "default",
+  "cache": {
+    "enabled": true,
+    "ttlSeconds": 3600
+  },
+  "sanitize": {
+    "removePII": false
+  },
+  "references": [
+    {
+      "name": "Microsoft BC Telemetry Samples",
+      "type": "github",
+      "url": "https://github.com/microsoft/BCTech",
+      "enabled": true
+    }
+  ]
 }

package/CHANGELOG.md

@@ -1,131 +1,131 @@
-# MCP Backend Changelog
-
-All notable changes to the BC Telemetry Buddy MCP backend will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [1.0.0] - 2025-11-18
-
-### 🚨 BREAKING CHANGES
-
-**First standalone release of BC Telemetry Buddy MCP Server**
-
-This is the first release of the MCP server as a standalone NPM package, separated from the VSCode extension.
-
-**Major Changes:**
-- **Standalone Package**: Published as `bc-telemetry-buddy-mcp` on NPM
-- **CLI Interface**: New `bctb-mcp` CLI with commands: `start`, `init`, `validate`, `test-auth`
-- **File-Based Configuration**: Uses `.bctb-config.json` instead of environment variables
-- **Multi-Profile Support**: Manage multiple customer environments in single config file
-- **Shared Core**: Uses `@bctb/shared` library for business logic (bundled at build time)
-
-### Added
-
-- **CLI Commands**: `bctb-mcp start`, `bctb-mcp init`, `bctb-mcp validate`, `bctb-mcp test-auth`
-- **File-Based Configuration**: Support for `.bctb-config.json` with config discovery
-- **Multi-Profile Support**: Named profiles with inheritance and environment variable substitution
-- **Profile Switching**: Support for `--profile` flag and `BCTB_PROFILE` environment variable
-- **Config Schema**: JSON schema for `.bctb-config.json` validation
-- **Standalone Mode**: Can run independently without VSCode extension
-
-### Changed
-
-- **Architecture**: Refactored to use `@bctb/shared` library for core functionality
-- **Configuration**: Migrated from environment variables to file-based config
-- **Distribution**: Published to NPM for global installation (`npm install -g bc-telemetry-buddy-mcp`)
-
-### Migration Notes
-
-- See [MIGRATION.md](../../MIGRATION.md) for upgrade guide from bundled v0.2.x
-- Extension v0.3.0+ offers automatic MCP installation and configuration
-- Old environment variable config still supported as fallback
-
-## [0.2.22] - 2025-11-01
-
-### Changed
-- No MCP backend changes in this release (extension-only changes for workspace validation and configuration handling)
-
-## [0.2.21] - 2025-10-29
-
-### Changed
-- Cache folder creation made lazy: `.vscode/.bctb/cache` is no longer created at server startup. It's created only on first cache write.
-- `clear()` and `cleanupExpired()` now return early if the cache directory does not exist, avoiding unnecessary filesystem operations.
-
-## [0.2.20] - 2025-10-22
-
-### Changed
-- No MCP backend changes in this release (extension-only feature for multiple chatmodes)
-
-## [0.2.19] - 2025-10-22
-
-### Fixed
-- No MCP backend changes in this release (extension-only fix for settings validation)
-
-## [0.2.18] - 2025-10-22
-
-### Changed
-- **Queries folder**: Implemented lazy creation - queries folder only created when first query is saved, not on QueriesService initialization
-
-## [0.2.17] - 2025-10-20
-
-### Changed
-- **Event catalog**: Improved shortMessage logic for unique event identification - converted nested iif() to case() statement with specific handlers for RT0048, LC0169, and LC0170 events to prevent duplicate eventId entries in catalog
-
-## [0.2.16] - 2025-10-20
-
-### Fixed
-- **Release process**: Simplified release workflow - manually update package.json version and CHANGELOG, commit, then create GitHub release
-
-## [0.2.15] - 2025-10-20
-
-### Fixed
-- **Release process**: Corrected release workflow to ensure version bump and CHANGELOG updates are committed together in a single atomic commit
-
-## [0.2.14] - 2025-10-20
-
-### Added
-- `get_event_field_samples` tool: Analyzes customDimensions structure for specific event IDs with field types, occurrence rates, sample values, and ready-to-use KQL templates
-- `get_event_catalog` enhancement: Added `includeCommonFields` parameter that analyzes field prevalence across events, categorizing fields into Universal (80%+), Common (50-79%), Occasional (20-49%), and Rare (<20%) with type detection and actionable recommendations
-- Dynamic event category lookup: Analyzes event messages and metadata to determine appropriate categorization (Lifecycle, Performance, Security, Error, Integration, Configuration, Custom)
-- Message field priority in event analysis: Enhanced custom event categorization by analyzing actual telemetry message content
-
-### Changed
-- **BREAKING**: Removed natural language translation from `query_telemetry` tool - removed `nl` parameter and all pattern-matching logic. Users should use discovery tools (`get_event_catalog`, `get_event_field_samples`) to understand telemetry structure before writing KQL queries
-- `query_telemetry` now only accepts explicit KQL queries (no NL translation)
-- Tool descriptions updated to guide users toward data-driven discovery workflow
-
-### Fixed
-- **First-run experience**: MCP server now starts gracefully with incomplete configuration instead of exiting with code 1, allowing setup wizard to guide new users through configuration. `validateConfig()` returns errors array instead of throwing exceptions, enabling degraded mode with helpful error messages directing users to setup wizard.
-
-### Removed
-- `translateNLToKQL` method and supporting pattern-matching code (unreliable keyword-based translation that misled GitHub Copilot)
-
-## [0.2.1] - 2025-10-17
-
-### Changed
-- Launcher: renamed from `server.cjs` to `launcher.js` to ensure reliable VSIX packaging and installation across all VSCode versions. Preserves CommonJS semantics while using `.js` extension that VSCode handles correctly.
-
-## [0.2.0] - 2025-10-17
-
-### Fixed
-- Marketplace bundling: bundle MCP server into a single `dist/server.js` (esbuild) and ensure the extension copies the bundle into `packages/extension/mcp/dist/server.js` before packaging. Fixes runtime errors in marketplace installs where MCP couldn't be found and ensures the MCP server runs without requiring separate node_modules in the published extension.
-
-## [0.1.0] - 2025-10-15
-
-### Added
-- Project structure and configuration
-- TypeScript setup with ES2022 + ESM
-- Jest testing framework
-- Package.json with dependencies
-- Initial MCP backend scaffold
-- Express server with JSON-RPC protocol support
-- MSAL authentication (device_code and client_credentials flows)
-- File-based caching with TTL
-- Kusto/Application Insights query execution
-- Saved queries management (.kql files)
-- External references fetching (GitHub API)
-- PII sanitization (opt-in)
+# MCP Backend Changelog
+
+All notable changes to the BC Telemetry Buddy MCP backend will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2025-11-18
+
+### 🚨 BREAKING CHANGES
+
+**First standalone release of BC Telemetry Buddy MCP Server**
+
+This is the first release of the MCP server as a standalone NPM package, separated from the VSCode extension.
+
+**Major Changes:**
+- **Standalone Package**: Published as `bc-telemetry-buddy-mcp` on NPM
+- **CLI Interface**: New `bctb-mcp` CLI with commands: `start`, `init`, `validate`, `test-auth`
+- **File-Based Configuration**: Uses `.bctb-config.json` instead of environment variables
+- **Multi-Profile Support**: Manage multiple customer environments in single config file
+- **Shared Core**: Uses `@bctb/shared` library for business logic (bundled at build time)
+
+### Added
+
+- **CLI Commands**: `bctb-mcp start`, `bctb-mcp init`, `bctb-mcp validate`, `bctb-mcp test-auth`
+- **File-Based Configuration**: Support for `.bctb-config.json` with config discovery
+- **Multi-Profile Support**: Named profiles with inheritance and environment variable substitution
+- **Profile Switching**: Support for `--profile` flag and `BCTB_PROFILE` environment variable
+- **Config Schema**: JSON schema for `.bctb-config.json` validation
+- **Standalone Mode**: Can run independently without VSCode extension
+
+### Changed
+
+- **Architecture**: Refactored to use `@bctb/shared` library for core functionality
+- **Configuration**: Migrated from environment variables to file-based config
+- **Distribution**: Published to NPM for global installation (`npm install -g bc-telemetry-buddy-mcp`)
+
+### Migration Notes
+
+- See [MIGRATION.md](../../MIGRATION.md) for upgrade guide from bundled v0.2.x
+- Extension v0.3.0+ offers automatic MCP installation and configuration
+- Old environment variable config still supported as fallback
+
+## [0.2.22] - 2025-11-01
+
+### Changed
+- No MCP backend changes in this release (extension-only changes for workspace validation and configuration handling)
+
+## [0.2.21] - 2025-10-29
+
+### Changed
+- Cache folder creation made lazy: `.vscode/.bctb/cache` is no longer created at server startup. It's created only on first cache write.
+- `clear()` and `cleanupExpired()` now return early if the cache directory does not exist, avoiding unnecessary filesystem operations.
+
+## [0.2.20] - 2025-10-22
+
+### Changed
+- No MCP backend changes in this release (extension-only feature for multiple chatmodes)
+
+## [0.2.19] - 2025-10-22
+
+### Fixed
+- No MCP backend changes in this release (extension-only fix for settings validation)
+
+## [0.2.18] - 2025-10-22
+
+### Changed
+- **Queries folder**: Implemented lazy creation - queries folder only created when first query is saved, not on QueriesService initialization
+
+## [0.2.17] - 2025-10-20
+
+### Changed
+- **Event catalog**: Improved shortMessage logic for unique event identification - converted nested iif() to case() statement with specific handlers for RT0048, LC0169, and LC0170 events to prevent duplicate eventId entries in catalog
+
+## [0.2.16] - 2025-10-20
+
+### Fixed
+- **Release process**: Simplified release workflow - manually update package.json version and CHANGELOG, commit, then create GitHub release
+
+## [0.2.15] - 2025-10-20
+
+### Fixed
+- **Release process**: Corrected release workflow to ensure version bump and CHANGELOG updates are committed together in a single atomic commit
+
+## [0.2.14] - 2025-10-20
+
+### Added
+- `get_event_field_samples` tool: Analyzes customDimensions structure for specific event IDs with field types, occurrence rates, sample values, and ready-to-use KQL templates
+- `get_event_catalog` enhancement: Added `includeCommonFields` parameter that analyzes field prevalence across events, categorizing fields into Universal (80%+), Common (50-79%), Occasional (20-49%), and Rare (<20%) with type detection and actionable recommendations
+- Dynamic event category lookup: Analyzes event messages and metadata to determine appropriate categorization (Lifecycle, Performance, Security, Error, Integration, Configuration, Custom)
+- Message field priority in event analysis: Enhanced custom event categorization by analyzing actual telemetry message content
+
+### Changed
+- **BREAKING**: Removed natural language translation from `query_telemetry` tool - removed `nl` parameter and all pattern-matching logic. Users should use discovery tools (`get_event_catalog`, `get_event_field_samples`) to understand telemetry structure before writing KQL queries
+- `query_telemetry` now only accepts explicit KQL queries (no NL translation)
+- Tool descriptions updated to guide users toward data-driven discovery workflow
+
+### Fixed
+- **First-run experience**: MCP server now starts gracefully with incomplete configuration instead of exiting with code 1, allowing setup wizard to guide new users through configuration. `validateConfig()` returns errors array instead of throwing exceptions, enabling degraded mode with helpful error messages directing users to setup wizard.
+
+### Removed
+- `translateNLToKQL` method and supporting pattern-matching code (unreliable keyword-based translation that misled GitHub Copilot)
+
+## [0.2.1] - 2025-10-17
+
+### Changed
+- Launcher: renamed from `server.cjs` to `launcher.js` to ensure reliable VSIX packaging and installation across all VSCode versions. Preserves CommonJS semantics while using `.js` extension that VSCode handles correctly.
+
+## [0.2.0] - 2025-10-17
+
+### Fixed
+- Marketplace bundling: bundle MCP server into a single `dist/server.js` (esbuild) and ensure the extension copies the bundle into `packages/extension/mcp/dist/server.js` before packaging. Fixes runtime errors in marketplace installs where MCP couldn't be found and ensures the MCP server runs without requiring separate node_modules in the published extension.
+
+## [0.1.0] - 2025-10-15
+
+### Added
+- Project structure and configuration
+- TypeScript setup with ES2022 + ESM
+- Jest testing framework
+- Package.json with dependencies
+- Initial MCP backend scaffold
+- Express server with JSON-RPC protocol support
+- MSAL authentication (device_code and client_credentials flows)
+- File-based caching with TTL
+- Kusto/Application Insights query execution
+- Saved queries management (.kql files)
+- External references fetching (GitHub API)
+- PII sanitization (opt-in)
 - Recommendations engine (heuristics-based)