bc-telemetry-buddy-mcp 3.2.4 → 3.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +21 -0
- package/config-schema.json +39 -0
- package/dist/cli.js +215 -165
- package/dist/launcher.js +8 -0
- package/dist/server.js +187 -137
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [3.3.0] - 2026-04-05
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
- **Community Knowledge Base (Issue #107)**: Two-layer KB system that loads at MCP startup. Community articles fetched from GitHub (`/knowledge-base/`) and cached for offline use; local articles from `{workspace}/.vscode/.bctb/knowledge/`. Falls back to cache if GitHub is unreachable — never fails startup.
|
|
14
|
+
- **`get_knowledge` tool**: Search the KB by `eventId`, `category`, `tags`, free-text `search`, or `source` (`community`/`local`/`all`). Returns matching articles with content, tags, and source info.
|
|
15
|
+
- **`save_knowledge` tool**: Save investigation patterns locally (`target: local` writes to workspace) or contribute back to the community (`target: community` creates a GitHub PR). Agent-only, user-initiated — 4-step workflow (preview → confirm level → generate → confirm).
|
|
16
|
+
- **`knowledgeBase` config block**: New optional `knowledgeBase` section in `.bctb-config.json` with `enabled`, `source`, `exclude`, `autoRefresh`, `cacheOnly`, and `githubToken` fields.
|
|
17
|
+
- **Seed KB articles**: 4 community articles shipped in `/knowledge-base/` covering lock timeouts (RT0012/RT0013), job queue health (AL0000E24-E27), environment upgrade lifecycle (LC events), and database wait statistics (RT0026).
|
|
18
|
+
- **`knowledge-base/index.json`**: Auto-generated index of all community articles (regenerated by CI on push to main).
|
|
19
|
+
- **`scripts/generate-kb-index.js`**: Script to regenerate `index.json` from article frontmatter.
|
|
20
|
+
- **Server instructions updated**: `SERVER_INSTRUCTIONS` now guides agents to check KB before writing KQL from scratch.
|
|
21
|
+
|
|
22
|
+
### Fixed
|
|
23
|
+
- **`knowledgeBase` type safety**: `MCPConfig` now declares `knowledgeBase?: KBConfig`, removing the `as any` cast in `mcpSdkServer.ts`.
|
|
24
|
+
|
|
25
|
+
### Added
|
|
26
|
+
- **Question coaching and answer validation**: Enhanced prompts with question coaching guidance and answer validation to improve agent response quality.
|
|
27
|
+
|
|
28
|
+
### Fixed
|
|
29
|
+
- **CI test stability**: Resolved CI failure by replacing hardcoded date with dynamic date in context tests.
|
|
30
|
+
|
|
10
31
|
## [3.2.4] - 2026-03-06
|
|
11
32
|
|
|
12
33
|
### Added
|
package/config-schema.json
CHANGED
|
@@ -99,6 +99,45 @@
|
|
|
99
99
|
"$ref": "#/definitions/reference"
|
|
100
100
|
}
|
|
101
101
|
},
|
|
102
|
+
"knowledgeBase": {
|
|
103
|
+
"type": "object",
|
|
104
|
+
"description": "Knowledge Base configuration — community and local KB articles",
|
|
105
|
+
"properties": {
|
|
106
|
+
"enabled": {
|
|
107
|
+
"type": "boolean",
|
|
108
|
+
"description": "Enable community Knowledge Base (local KB is always available)",
|
|
109
|
+
"default": true
|
|
110
|
+
},
|
|
111
|
+
"source": {
|
|
112
|
+
"type": "string",
|
|
113
|
+
"description": "GitHub URL for community KB repository folder",
|
|
114
|
+
"default": "https://github.com/waldo1001/waldo.BCTelemetryBuddy/tree/main/knowledge-base"
|
|
115
|
+
},
|
|
116
|
+
"exclude": {
|
|
117
|
+
"type": "array",
|
|
118
|
+
"description": "Article IDs (slugs) to exclude from community KB",
|
|
119
|
+
"items": {
|
|
120
|
+
"type": "string"
|
|
121
|
+
},
|
|
122
|
+
"default": []
|
|
123
|
+
},
|
|
124
|
+
"autoRefresh": {
|
|
125
|
+
"type": "boolean",
|
|
126
|
+
"description": "Refresh community KB from GitHub on startup",
|
|
127
|
+
"default": true
|
|
128
|
+
},
|
|
129
|
+
"cacheOnly": {
|
|
130
|
+
"type": "boolean",
|
|
131
|
+
"description": "Skip GitHub fetch, use cached community KB only",
|
|
132
|
+
"default": false
|
|
133
|
+
},
|
|
134
|
+
"githubToken": {
|
|
135
|
+
"type": "string",
|
|
136
|
+
"description": "GitHub personal access token for community KB contributions (PR creation). Can also be set via BCTB_GITHUB_TOKEN env var.",
|
|
137
|
+
"default": ""
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
},
|
|
102
141
|
"agents": {
|
|
103
142
|
"type": "object",
|
|
104
143
|
"description": "Agentic Autonomous Telemetry Monitoring — configuration for scheduled monitoring agents that run via bctb-mcp agent commands or CI/CD pipelines.",
|