CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

2.0.1 (2026-06-17)

Bug Fixes

• tools pf-3836 strict url validation and pf uris (#227) (c3bda33)

2.0.0 (2026-06-15)

★ HIGHLIGHTS

• Context management, a refined token-optimized MCP tool that turns the two existing MCP tools into a single MCP tool called searchPatternFly. This work is an architecture gateway to even more token optimizations planned for version 2.x.x and experimental settings. Learn how to activate context management
• Multiple behind-the-scenes optimizations and refactors, like parallel search filtering and registering experimental options, to keep the MCP stable and running smoothly.

⚠ BREAKING CHANGES

• Node.js 20 support has been removed. Either pin the existing PatternFly MCP package to continue using Node.js 20 or move to using Node.js 22 for version 2.0.0. Why Node.js 20 was dropped, see our planned architecture.
• Programmatic use server options are now limited. Previously, any server options field could be supplied programmatically. Extra keys are simply ignored now. See the refined options.

Features

• tools pf-4120 resource optimized searchPatternFly (#211) (f7eeb96)
• tools,resources pf-4120 conditional registration (#215) (b2e0f44)
• search pf-4120 parallel result filtering (#210) (c604bcc)
• skills pf-4236 zod integration reports (#206) (fea5c19)
• ⚠ options pf-4119 programmatic, CLI, experimental registry (#200) (0a3420d)

Documentation

• pf-4128 governance, security policies (#221) (e9b0086)

Code Refactoring

• docs pf-3874 pf release updates (#219) (41e31c9)
• tools pf-3836 allow search by uri, hash, path (#207) (88f8ede)
• server pf-3836 processDocsFunction, metadata, errors (#209) (20faaba)
• typings pf-4119 rename, deprecate cli options (#199) (ad97803)
• mcpSdk,server pf-3836 sdk related typings (#198) (50ebb04)
• server pf-3836 colocate register tools, resources (#197) (7318252)
• options pf-4119 plugin isolation list (#196) (bb557ee)

Builds

• deps lock update (#220) (81dc3f7)
• deps-dev bump pkgroll from 2.27.0 to 2.27.1 (#217) (6a5aa7b)
• deps bump semver from 7.8.0 to 7.8.1 (#218) (9639c72)
• deps-dev bump dev group with 7 updates (#214) (af3f33d)
• deps bump actions/setup-node from 6.3.0 to 6.4.0 (#213) (0b16801)
• deps bump semver from 7.7.4 to 7.8.0 (#208) (69a0d13)
• deps bump zod from 4.3.6 to 4.4.3 (#202) (fce59ff)
• ⚠ node.js pf-3843 remove 20 support (#169) (589a390)
• deps-dev bump the dev group with 3 updates (#195) (88e5122)

Bug Fixes

• pf-4120 central mcp sdk typings (#216) (05053d7)

1.1.0 (2026-05-11)

Features

• cli,resources pf-4059 cli catch start issues (#179) (5974f60)

Documentation

• troubleshooting steps, examples (#173) (e69a213)

Code Refactoring

• docs pf-4036 pf-cli references (#170) (3b004b7)

Chores

• add pf team label workflow (#177) (db78d35)

Builds

• deps lock update (#191) (de4fbe8)
• deps lock update (#189) (f75460f)
• deps-dev bump dev group with 4 updates (#180) (10a49da)
• deps bump actions/setup-node from 6 to 6.3.0 (#178) (c16a164)
• add codeowners, pr reviews (#175) (70c9470)
• deps-dev bump dev group with 4 updates (#174) (871098a)

Bug Fixes

• patternfly keyword exception list filter (#171) (77f664f)

1.0.1 (2026-04-27)

Documentation

• remove update skill refs for docs.json (#167) (7d6b188)

Chores

• docs pf-4036 add pf-cli, ai-helpers intros (#166) (5a63c12)

Builds

• workflow, coverage, issue templates (#164) (ec5c76f)
• deps-dev bump dev group with 4 updates (#162) (cee9368)
• deps lock update (#161) (5c9e9ba)
• deps @modelcontextprotocol/sdk from 1.27.1 to 1.29.0 (#159) (161fca1)
• deps bump pid-port from 2.1.0 to 2.1.1 (#158) (1976ade)
• deps-dev bump dev group with 5 updates (#157) (ae338dd)
• deps-dev bump dev group with 3 updates (#152) (d2d65c4)
• deps bump pid-port from 2.0.1 to 2.1.0 (#150) (6a47a78)
• deps-dev bump dev group with 4 updates (#149) (b6f99ea)

Bug Fixes

• server catch tool registration errors (#155) (934f7c7)

1.0.0 (2026-03-30)

⚠ BREAKING CHANGES, remove componentSchemas MCP tool, favor MCP resources instead, see #137

Features

• generate meta resources (#130) (083adc0)

Documentation

• consistent casing, copy, grammar, spacing (#144) (784be0a)
• update usage, architecture, maintenance (#143) (7a2188f)
• add contributor, repo skills (#136) (365e318)

Code Refactoring

• ⚠ tools remove componentSchemas tool (#137) (396b0d5)

Builds

• deps lock update (#145) (d7185c7)
• deps lock update (#140) (560a3c1)
• deps-dev bump dev group with 8 updates (#138) (77c9c40)
• deps-dev bump dev group with 2 updates (#135) (45509c0)

Bug Fixes

• resources schemas index mimeType (#133) (8585475)

0.9.0 (2026-03-17)

⚠ May contain a breaking update for embedded use only. Move from docsPath: string to docsPaths: string[] with a behavior shift, see #125

Features

• activate resource completions (#107) (09563dd)
• server expose instructions (#128) (d7df9c2)

Code Refactoring

• tools combine components, docs for search (#129) (c2b7176)
• docs migrate to ai-helpers (#125) (124f41e)

Chores

• docs add codemods, getting started guides (#124) (4492355)

Builds

• deps lock update (#131) (b097f50)
• deps @modelcontextprotocol/sdk from 1.27.0 to 1.27.1 (#127) (dd4b2b5)
• deps-dev bump dev group with 8 updates (#126) (ca3d6c8)

0.8.0 (2026-03-05)

Features

• nodejs assertions base (#113) (d537fd6)
• patternFly find closest pf version (#102) (af09f10)
• server.search allow partial matchTypes (#100) (e36c2de)

Code Refactoring

• api base, move to docs.json (#120) (1f5e4d6)
• centralize search, get resources (#106) (a381ed5)
• e2e,audit,docs relocate tests, convert links to json (#105) (1df4434)
• options mode options, e2e testing mocks (#98) (06fdcdc)

Chores

• docs add ai, extensions, foundations, styles guidance (#121) (c04aa0d)
• pr template (#119) (c99afea)

Builds

• deps lock update (#122) (d0fa57a)
• deps @modelcontextprotocol/sdk from 1.26.0 to 1.27.0 (#118) (3d8cb74)
• deps-dev bump dev group with 4 updates (#116) (8735c0a)
• deps @modelcontextprotocol/sdk from 1.25.3 to 1.26.0 (#111) (2dfe03b)
• deps bump semver from 7.7.3 to 7.7.4 (#110) (65407d1)
• deps-dev bump dev group with 5 updates (#109) (1638e1b)
• deps-dev bump dev group with 4 updates (#104) (4c52846)
• deps bump zod from 4.3.5 to 4.3.6 (#103) (00bbd0d)
• deps-dev bump dev group with 6 updates (#101) (1e10745)
• deps @modelcontextprotocol/sdk from 1.25.2 to 1.25.3 (#97) (e7063bf)

Bug Fixes

• search search filters, keyword mapping (#112) (a7861d1)

0.7.0 (2026-02-02)

Documentation

• restructure, expand documentation (#81) (1d69fcd)

Code Refactoring

• remove unused llms files, docsHost option (#89) (b056d5b)

Builds

• deps bump actions/checkout from 4 to 6 (#94) (8eae252)
• deps lock update (#93) (5726c87)
• deps-dev bump dev group with 4 updates (#91) (5d60f08)
• deps bump prod group with 2 updates (#92) (2275313)
• deps bump zod from 4.2.1 to 4.3.5 (#86) (764b55f)
• deps-dev bump the dev group with 5 updates (#85) (7031dc3)

Bug Fixes

• getResources move dotenv to default options (#90) (34a250b)
• search, max string length (#88) (0d607db)

0.6.0 (2026-01-19)

Features

• search,resources search for docs, migrate to mcp resources (#74) (2cb5ca7)
• stats getStats, server report channels (#78) (3b7c9a0)

Builds

• deps @modelcontextprotocol/sdk from 1.24.3 to 1.25.1 (#66) (fbabe34)
• deps-dev bump the dev group with 3 updates (#79) (e7e5c64)
• deps-dev bump @types/node from 24.10.1 to 25.0.3 (#77) (562b4a6)
• deps-dev bump the dev group with 3 updates (#76) (0a8eb99)

Bug Fixes

• stat report typing (#83) (c86ad8a)

0.5.0 (2026-01-05)

Tests

• minor typing, annotation, config refactor (#55) (83c6f2d)
• lint consistency (#45) (f0c2a34)

Features

• tools-plugins allow mcp tool plugins (#41) (e6a9aed)
• tools-user user-facing helpers for tools-as-plugins (#63) (84c9efb)
• tools-host creators, child validation for tools-as-plugins (#62) (97f855a)
• logger format unknown errors (#59) (55df65e)
• schema schema support helpers (#57) (e55eea5)
• memo, add keyHash option (#54) (0755c28)

Code Refactoring

• options, nodejs version, path resolves (#58) (6634b01)
• server use builtInTools const, logging, annotations (#56) (048a70a)

Builds

• deps bump actions/cache from 4 to 5 (#69) (870fd68)
• deps bump actions/setup-node from 4 to 6 (#68) (f14605a)
• deps-dev bump dev group with 4 updates (#67) (b34425f)
• deps bump @modelcontextprotocol/sdk in the prod group (#65) (be4f884)
• deps @modelcontextprotocol/sdk from 1.23.0 to 1.24.1 (#53) (3986841)
• deps-dev bump dev group with 3 updates (#51) (49d37d9)
• deps-dev bump dev group with 4 updates (#50) (729dcd9)
• deps @modelcontextprotocol/sdk from 1.22.0 to 1.23.0 (#48) (25b63c8)
• deps-dev @types/node from 22.18.8 to 24.10.1 (#47) (b8b72d9)

Bug Fixes

• server clean sigint handler on shutdown (#72) (3ee99f5)
• logger avoid recursive error handling (#71) (fb78d63)

0.4.0 (2025-12-07)

Tests

• update fetchMock routing (#31) (51bbc31)

Features

• support http transport (#1) (12e8734)

Code Refactoring

• cli as standalone (#30) (55e3360)

Builds

• deps-dev bump dev group with 7 updates (#37) (6a65e19)
• deps @modelcontextprotocol/sdk from 1.19.1 to 1.22.0 (#36) (8a81066)
• activate dependabot (#33) (5b91b72)

Bug Fixes

• cli http port option, typings (#40) (727fc0a)
• allow process to exit, consistent imports (#32) (fa5c734)

0.3.0 (2025-12-03)

Features

• log channels, avoid polluting stdout (#25) (cc82731)

Bug Fixes

• markdown format for links (#28) (53d69b5)

0.2.0 (2025-11-30)

Tests

• stdio client refactor for e2e (#16) (ce9970c)

Features

• memo cache expire, rollout callbacks (#17) (c9e4838)
• schemas add component-schemas tool (#12) (4e58b28)
• shortest distance search helpers (#14) (0f2b54a)
• expose server-instance stop, status (#9) (68222cb)

Code Refactoring

• patternfly doc path updates (#26) (12334cf)
• move from global to context options (#10) (aa134f6)

Bug Fixes

• os agnostic repoName (#15) (bb8f4be)

0.1.0 (2025-10-23)

General

• Initial commit (e085648)

Features

• programmatic option override (#5) (ad96c74)

Continuous Integrations

• npm publish workflow (#8) (26236ab)

Builds

• changelog generator (#6) (6068954)
• mcp-config to patternfly package (#4) (c1e13eb)
• move to nodejs 20 (#3) (c60fec1)
• move to patternfly branding (#2) (3000fb5)