CHANGELOG.md

Changelog

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

2.3.0 (2026-08-24)

Features

• collections pf-4401 patternfly api base (#274) (9f08cc2)
• collections pf-4401 worker threads (#276) (3ee24ef)
• collections pf-4401 collection plugins base (#272) (2ce5d7b)

Code Refactoring

• collections pf-4402 move to listeners (#281) (892c81e)
• pf-4401 centralize toolsUser helpers (#275) (76b4049)
• server pf-4401 centralize child-process, ipc, host (#262) (c43005f)

Builds

• deps-dev bump dev group with 5 updates (#283) (d8bf77f)
• deps patternfly-component-schemas from 1.2.0 to 1.3.0 (#280) (4248588)
• deps lock update (#279) (35abcea)
• deps bump @modelcontextprotocol/sdk (#278) (cb7591d)
• deps-dev bump the dev group with 2 updates (#277) (031954f)
• deps-dev bump the dev group with 5 updates (#270) (95ade3d)
• pf-4265 compass links, package ref (#269) (ec35bc1)
• deps bump actions/setup-node from 6.4.0 to 7.0.0 (#267) (315dbf0)
• pf-4265 apply compass config (#261) (e9629eb)
• deps-dev bump the dev group with 6 updates (#265) (9b32f68)

Bug Fixes

• deferTask pf-4402 continueOnError, schedule padding (#288) (dfa8eed)
• server prevent dropped http error events on startup (#287) (d98a3d5)
• buildPersistentPool pf-4402 reset after crash, cap respawn (#284) (a9f520a)
• server avoid stopping parent with embedded server (#285) (db61968)
• server behavior, clarity annotations (#286) (4a91509)

2.2.0 (2026-07-28)

Features

• pf-4387 enhance memo, add clear cache method (#249) (4e6eabe)
• pf-4387 expand and enhance fetch (#248) (17a2fe3)

Code Refactoring

• docs release updates, uxd ai helpers (#263) (36caaa9)

Builds

• deps-dev bump @cdcabrera/eslint-config-toolkit (#260) (b1de9df)
• deps-dev bump @types/node from 25.9.3 to 26.1.0 (#251) (5830236)
• deps-dev bump dev group with 5 updates (#256) (c345713)

2.1.0 (2026-07-20)

⚠ Potential breaking changes

• Diagnostic channel names for logging and stats now include a mode prefix. This affects programmatic server implementations that manually parse channel names. See #233.
• Moved URL whitelist and protocols from patternflyOptions to a new top-level object. This may affect maintainers using internal programmatic defaults. See #254.

Tests

• pf-4387 stdio client logging flake (#253) (9175e06)

Features

• pf-4298 build, run container (#231) (c207c42)

Code Refactoring

• assertions pf-4387 allow codes, errors for assertions (#252) (93efa31)
• options pf-4387 centralize url whitelist (#254) (b87aeae)
• options pf-3874 log to channel basename (#233) (2659a24)

Builds

• deps lock update (#257) (a67ace7)
• deps bump semver from 7.8.4 to 7.8.5 (#245) (8dcadfb)
• deps-dev bump dev group with 3 updates (#244) (9aebad4)
• deps bump actions/checkout from 6 to 7 (#235) (4c35c79)
• deps-dev bump eslint from 9.39.4 to 10.5.0 (#237) (c51fcd0)
• deps-dev bump dev group with 3 updates (#236) (3190577)
• deps-dev bump dev group with 4 updates (#229) (0379f61)
• deps bump semver from 7.8.1 to 7.8.4 (#230) (8d64d23)
• deps-dev bump cspell from 9.7.0 to 10.0.1 (#226) (818016b)
• deps-dev bump dev group with 4 updates (#225) (576d996)

Bug Fixes

• assertions pf-4387 block non-urls (#255) (441b1a1)
• stats pf-3874 move to managed task handler (#234) (8cddf8c)

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)