feat(patternFly): find closest pf version

* build, semver package for version checks
* docs, guidance example aligned
* options, semver defaults for available patternfly
* patternFly.helpers, find closest pf version
* server.getResources, findNearestPackageJson, matchPackageVersion
* server.helpers, expand isUrl, add isPath
* server.toolsUser, move to isUrl, isPath from server.helpers

Author: cdcabrera

cspell.config.json

@@ -11,6 +11,7 @@
     "onsessionclosed",
     "patternfly",
     "rereview",
+    "rsort",
     "sparkline",
     "streamable",
     "unrepresentable",

guidelines/agent_behaviors.md

@@ -118,11 +118,15 @@ When implementing tools that interact with the local filesystem, always use `res
 ```typescript
 import { resolveLocalPathFunction } from './server.getResources';
 // ...
-const safePath = await resolveLocalPathFunction(requestedPath, rootDir);
+let safePath;
 
-if (!safePath) {
+try {
+  safePath = resolveLocalPathFunction(requestedPath);
+} catch {
   throw new McpError(ErrorCode.InvalidParams, 'Access denied');
 }
+
+// use safePath for subsequent file operations
 ```
 
 ### 6.2 Plugin Isolation

package-lock.json

@@ -59,12 +59,14 @@
     "@patternfly/patternfly-component-schemas": "1.2.0",
     "fastest-levenshtein": "1.0.16",
     "pid-port": "2.0.1",
+    "semver": "7.7.3",
     "zod": "4.3.5"
   },
   "devDependencies": {
     "@cdcabrera/eslint-config-toolkit": "^0.4.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^25.0.10",
+    "@types/semver": "7.7.1",
     "@typescript-eslint/eslint-plugin": "^8.54.0",
     "@typescript-eslint/parser": "^8.54.0",
     "changelog-light": "^3.0.5",

package.json

@@ -32,10 +32,10 @@ exports[`options defaults should return specific properties: defaults 1`] = `
   "nodeVersion": 22,
   "patternflyOptions": {
     "availableResourceVersions": [
-      "v6",
+      "6.0.0",
     ],
     "default": {
-      "defaultVersion": "v6",
+      "defaultVersion": "6.0.0",
       "versionStrategy": "highest",
       "versionWhitelist": [
         "@patternfly/react-core",