w3c-mcp

# Changelog All notable changes to this project 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). ## [0.1.7] - 2026-02-05 ### Fixed - **npm package**: Added `README.md` to `files` field in `package.json` - Previously README was not included in published package - npm now displays the README on the package page ## [0.1.6] - 2026-02-05 ### Added - **`src/constants/index.ts`**: Centralized configuration constants - `SEARCH_SCORES` - All search scoring values with `as const` - `SearchScoreKey`, `SearchScoreValue` types for type-safe score access - `PwaShortname`, `CorePwaShortname`, `PwaKeyword` types derived from const arrays - `DEFAULT_LIST_LIMIT`, `MAX_LIST_LIMIT`, `DEFAULT_SEARCH_LIMIT`, `MAX_SEARCH_LIMIT` - `CSSWG_URL_PATTERN`, `UNKNOWN_SPEC` for CSS URL parsing - **`src/utils/suggestions.ts`**: DRY extraction of suggestion generation - `generateSpecSuggestions()` - Generate suggestions for spec lookups - `generateWebIDLSuggestions()` - Generate suggestions for WebIDL lookups - `toOptionalSuggestions()` - Convert empty arrays to undefined - **`src/utils/search.ts`**: Generic search utilities - `filterByName<T>()` - Generic filter function for name-based search - `normalizeElementName()` - Normalize element names (strip angle brackets) - **`ErrorResponse` interface**: Structured error response type in `src/errors/index.ts` ### Changed - **Refactored tool implementations** to use centralized constants - `search-specs.ts` - Uses `SEARCH_SCORES` constants - `get-css.ts` - Uses `CSSWG_URL_PATTERN`, `UNKNOWN_SPEC` - `get-pwa-specs.ts` - Uses `PWA_SHORTNAMES`, `CORE_PWA_SHORTNAMES`, `PWA_KEYWORDS` - **Refactored error handling** to use `toJsonResponse()` helper - **Improved type safety** with const assertions and derived types ### Testing - Test coverage increased from 83.47% to **86.7%** - Test count increased from 163 to **190 tests** - `errors/index.ts` now has **100% coverage** (was 85.32%) - Added coverage tests for: - `QUERY_CONTAINS_SHORTNAME` score branch - `ALL_WORDS_MATCH` score branch - Abstract/description matching - All error class variations (`WebIDLNotFoundError`, `CSSNotFoundError`, `ElementsNotFoundError`) ## [0.1.5] - 2026-02-01 ### Fixed - **`get-webidl.ts`**: Multiple match case now uses `WebIDLNotFoundError` with suggestions - Previously used generic `Error`, now LLM receives suggestions for exact shortnames - **`getSpecDependencies`**: Now uses `SpecNotFoundError` with suggestions - Previously used generic `Error`, matching the pattern in `getSpec()` - **`formatErrorResponse`**: Added proper handling for `WebIDLNotFoundError` suggestions - Previously `WebIDLNotFoundError` suggestions were not included in error response ### Changed - **`WebIDLNotFoundError`**: Added `multipleMatch` parameter for accurate error messages - **`get_spec_dependencies` tool description**: Updated to clarify that dependency data is not yet available from upstream data source ## [0.1.4] - 2026-02-01 ### Changed - **Custom Error Classes**: Now properly used in all tool implementations - `get-spec.ts` uses `SpecNotFoundError` with suggestions - `get-webidl.ts` uses `WebIDLNotFoundError` with suggestions - `get-elements.ts` uses `ElementsNotFoundError` with limited suggestion count - **Dependency Versions**: Fixed versions for `@webref/*` and `web-specs` packages (previously `"latest"`) - `@webref/css`: `^8.2.1` - `@webref/elements`: `^2.6.1` - `@webref/idl`: `^3.71.1` - `web-specs`: `^3.76.0` - **Server Version**: Now dynamically loaded from `package.json` ### Added - **Utility Functions**: `toSpecSummary()` and `toSpecSummaries()` in `src/utils/mapper.ts` - Consolidates SpecSummary mapping logic from 4 different files ### Fixed - `ElementsNotFoundError` now limits available specs to 10 in error message (prevents overly long messages) - Removed unused `_foundPerfectMatch` variable in `search-specs.ts` ## [0.1.2] - 2025-01-24 ### Added - **Test Suite**: Comprehensive test coverage with Vitest (163 tests) - Unit tests for all data loaders and tools - Integration tests for MCP server functionality - ~82% code coverage - **Biome**: Fast linter and formatter for code quality - ESLint + Prettier replacement - Configured with TypeScript support ### Changed - Code cleanup via Biome auto-fixes (unused imports, `node:` protocol, etc.) ## [0.2.0] - 2025-01-24 ### Added - **Zod Input Validation**: Type-safe validation for all tool inputs with structured error responses - **Custom Error Classes**: `SpecNotFoundError`, `WebIDLNotFoundError`, `CSSNotFoundError`, `ElementsNotFoundError`, `ValidationError` with helpful suggestions - **Debug Logging**: Environment-based logging controlled by `W3C_MCP_DEBUG=true` - **Performance Logging**: Timing information for tool calls with `W3C_MCP_PERF=true` - **CI/CD Pipeline**: GitHub Actions workflow for Node.js 18/20/22 with automatic npm publishing ### Changed - Structured error responses with JSON format including error type, message, and suggestions - Improved error messages for not-found scenarios ### Performance - Promise-based singleton caching prevents duplicate data loads - Map-based spec index for O(1) lookups (previously O(n)) - Parallel data preloading at server startup (~70ms total) - Optimized search with pre-compiled regex and early termination ## [0.1.0] - 2025-01-24 ### Added - Initial release of W3C MCP Server - **Specification Discovery Tools** - `list_w3c_specs` - List W3C/WHATWG/IETF web specifications with filtering - `get_w3c_spec` - Get detailed information about a specific specification - `search_w3c_specs` - Search specifications by query - **WebIDL Tools** - `get_webidl` - Get WebIDL interface definitions for a specification - `list_webidl_specs` - List all specs with WebIDL definitions - **CSS Tools** - `get_css_properties` - Get CSS property definitions - `list_css_specs` - List all CSS specifications - **HTML Elements Tools** - `get_html_elements` - Get HTML element definitions - `list_element_specs` - List all specs with element definitions - **PWA Tools** - `get_pwa_specs` - Get all PWA-related specifications - `get_spec_dependencies` - Get specification dependency information