---
summary: "Telemetry visualization docs ([#125](https://github.com/cyanheads/mcp-ts-core/issues/125)) — example Grafana dashboard JSON, vendor-agnostic query recipes, new `api-telemetry` skill. Engines bumped to Bun ≥1.3.0 / Node ≥24.0.0."
breaking: false
security: false
---

# 0.8.19 — 2026-05-08

## Added

- **`docs/telemetry/dashboards.md` + `mcp-ts-core-dashboard.json`** ([#125](https://github.com/cyanheads/mcp-ts-core/issues/125)) — example Grafana dashboard (54 panels, schemaVersion 39) plus an import quickstart and equivalent query recipes for Datadog / NRQL / Honeycomb. Single `$service` template variable, `(?:@[^/]+/)?` regex strips any npm-org prefix, no publisher-specific names. `docs/telemetry/observability.md` cross-links it. Framework-source-only — `docs/` is intentionally not shipped in the npm `dist`.
- **`api-telemetry` skill** (v1.0) — catalog of every span, metric, attribute, completion-log field, env var, and runtime caveat the framework emits. Cross-linked from `api-utils` (which now scopes to the helper API only) and from CLAUDE.md/AGENTS.md skill index.
- **Changelog frontmatter `security: boolean`** — pairs with the `## Security` section to render a `🛡️ Security` badge in the rollup. Both flags render in fixed order (`· ⚠️ Breaking · 🛡️ Security`) when set. `scripts/build-changelog.ts` parses and validates `security` like `breaking` (must be literal `true`/`false`).
- **`init` template substitutions** — `{{MCP_SDK_VERSION}}` and `{{ZOD_VERSION}}` now resolve from the framework `package.json` `dependencies` map. Joins existing `{{PACKAGE_NAME}}` and `{{FRAMEWORK_VERSION}}`.

## Changed

- **Engines bumped:** Bun `>=1.2.0` → `>=1.3.0`, Node `>=22.0.0` → `>=24.0.0`. Mirrored in `templates/package.json` and `skills/polish-docs-meta/references/package-meta.md`.
- **Docker base image:** `oven/bun:1` → `oven/bun:1.3` (build + runtime stages, root and template Dockerfiles).
- **CLAUDE.md / AGENTS.md** — restructured: new "Consumers" section explains the package-import vs init-scaffolded paths up front; tool/format guidance condensed; standalone Git section dropped (the global protocol covers it). Now reflects 0.8.19 + Bun ≥1.3.0 / Node ≥24.0.0 in the header.
- **`changelog/template.md` / `templates/changelog/template.md`** — rewritten authoring guide: bold-the-symbol bullet style, Keep-a-Changelog section order, scaffolded `Deprecated` / `Removed` / `Security` sections (commented out by default).
- **`README.md`** — leaner feature list, reordered storage detail behind a single `node_modules` link, added cross-links to `docs/telemetry/observability.md` and `dashboards.md`.
- **Skill bumps:** `setup` 1.6 → 1.7 (rebrands `npx` examples to `bunx`, replaces `{{PACKAGE_NAME}}` placeholder guidance with substituted-name verification, adds `release-and-publish` to the rough progression). `maintenance` 2.0 → 2.1 — Phase C now also resyncs pristine reference files (`templates/changelog/template.md` → consumer `changelog/template.md`) on content-hash mismatch. `report-issue-framework` 1.5 → 1.6, `report-issue-local` 1.4 → 1.5 — terser issue-writing guidance, "cite cross-references once," Bun `1.3.x` examples. `api-utils` 2.1 → 2.2 — telemetry section header points readers to the new `api-telemetry` skill for the catalog.
- **Keywords:** added `bun`, `mcp-framework`; removed `edge`.
- **Dependency refresh:**
  - `@hono/node-server` `^2.0.1` → `^2.0.2`
  - `@cloudflare/vitest-pool-workers` `^0.16.0` → `^0.16.3`
  - `@cloudflare/workers-types` `^4.20260506.1` → `^4.20260508.1`
  - `@hono/otel` `^1.1.1` → `^1.1.2`
  - `@types/node` `^25.6.0` → `^25.6.2`
  - `openai` `^6.36.0` → `^6.37.0`
  - `vite` `8.0.10` → `8.0.11`
  - `fast-xml-parser` `^5.7.3` (new dev dep)
