@utilix-tech/mcp 0.66.0 → 0.67.0

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.67.0
+- Add `analyze_regex_groups` tool: parse a regex pattern's capture groups (numbered and named) and backreferences, flagging any backreference pointing at a group that doesn't exist or hasn't finished being defined yet at that point in the pattern.
+
 ## 0.66.0
 - Add `build_x_robots_tag`, `parse_x_robots_tag` tools: build an X-Robots-Tag response header from flag directives (noindex, nofollow, etc.) plus max-snippet/max-image-preview/max-video-preview/unavailable_after value directives, optionally scoped to a crawler user-agent, or parse an existing header into the same shape.
 - Add `lookup_websocket_opcode`, `list_websocket_opcodes` tools: look up what a WebSocket frame opcode means per RFC 6455's 4-bit opcode space, or list every opcode.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 227 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 228 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
 
 No API key required. All tools run locally. Requires Node.js 18 or later.
 
@@ -276,6 +276,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `lookup_mime` | Look up the MIME type for a file extension, or the extension(s) for a MIME type |
 | `parse_github_url` | Parse a github.com URL (repo, pull request, issue, commit, file, or release) into structured components |
 | `detect_redos` | Statically flag catastrophic-backtracking (ReDoS) risk in a regex: nested quantifiers, overlapping alternation, adjacent overlapping quantifiers |
+| `analyze_regex_groups` | Parse a regex's capture groups (numbered and named) and backreferences, flagging a backreference pointing at a group that doesn't exist or hasn't finished being defined yet |
 | `lint_conventional_commit` | Lint a commit message against the Conventional Commits v1.0.0 spec: header format, blank-line separation, footer tokens, and BREAKING CHANGE casing |
 | `test_gitignore_patterns` | Test a list of paths against a .gitignore file's patterns, following git's last-match-wins and negation rules |
 | `validate_editorconfig` | Validate an .editorconfig file: root flag, glob sections, and structural mistakes against the EditorConfig spec |

package/dist/index.js

@@ -4318,6 +4318,123 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+function _analyzeRegexGroupsMcp(pattern) {
+  let valid = true;
+  let compileError;
+  try {
+    new RegExp(pattern);
+  } catch (e) {
+    valid = false;
+    compileError = e instanceof Error ? e.message : String(e);
+  }
+  const groups = [];
+  const openStack = [];
+  const backreferences = [];
+  const issues = [];
+  let groupCount = 0;
+  let inClass = false;
+  for (let i = 0; i < pattern.length; i++) {
+    const ch = pattern[i];
+    if (ch === "\\" && i + 1 < pattern.length) {
+      const next = pattern[i + 1];
+      if (!inClass && /[1-9]/.test(next)) {
+        let j = i + 1;
+        while (j < pattern.length && /[0-9]/.test(pattern[j])) j++;
+        const raw = pattern.slice(i, j);
+        const target = parseInt(pattern.slice(i + 1, j), 10);
+        backreferences.push({ raw, target, start: i, resolved: false, definedBeforeUse: false });
+        i = j - 1;
+        continue;
+      }
+      if (!inClass && next === "k" && pattern[i + 2] === "<") {
+        const close = pattern.indexOf(">", i + 3);
+        if (close !== -1) {
+          const name = pattern.slice(i + 3, close);
+          const raw = pattern.slice(i, close + 1);
+          backreferences.push({ raw, target: name, start: i, resolved: false, definedBeforeUse: false });
+          i = close;
+          continue;
+        }
+      }
+      i++;
+      continue;
+    }
+    if (ch === "[" && !inClass) {
+      inClass = true;
+      continue;
+    }
+    if (ch === "]" && inClass) {
+      inClass = false;
+      continue;
+    }
+    if (inClass) continue;
+    if (ch === "(") {
+      if (pattern[i + 1] === "?") {
+        const c2 = pattern[i + 2];
+        if (c2 === ":" || c2 === "=" || c2 === "!") {
+          openStack.push({ index: -1, name: null, start: i });
+          continue;
+        }
+        if (c2 === "<" && (pattern[i + 3] === "=" || pattern[i + 3] === "!")) {
+          openStack.push({ index: -1, name: null, start: i });
+          continue;
+        }
+        if (c2 === "<") {
+          const close = pattern.indexOf(">", i + 3);
+          const name = close !== -1 ? pattern.slice(i + 3, close) : null;
+          groupCount++;
+          openStack.push({ index: groupCount, name, start: i });
+          if (close !== -1) i = close;
+          continue;
+        }
+        openStack.push({ index: -1, name: null, start: i });
+        continue;
+      }
+      groupCount++;
+      openStack.push({ index: groupCount, name: null, start: i });
+      continue;
+    }
+    if (ch === ")") {
+      const open = openStack.pop();
+      if (open && open.index !== -1) {
+        groups.push({ index: open.index, name: open.name, start: open.start, end: i });
+      }
+      continue;
+    }
+  }
+  for (const open of openStack) {
+    if (open.index !== -1) groups.push({ index: open.index, name: open.name, start: open.start, end: -1 });
+  }
+  groups.sort((a, b) => a.index - b.index);
+  const byIndex = new Map(groups.map((g) => [g.index, g]));
+  const byName = new Map(groups.filter((g) => g.name !== null).map((g) => [g.name, g]));
+  for (const b of backreferences) {
+    const g = typeof b.target === "number" ? byIndex.get(b.target) : byName.get(b.target);
+    if (!g) {
+      b.resolved = false;
+      b.definedBeforeUse = false;
+      const label = typeof b.target === "number" ? `group ${b.target}` : `named group "${b.target}"`;
+      issues.push({ severity: "error", message: `Backreference ${b.raw} at position ${b.start} points to ${label}, which doesn't exist in this pattern.` });
+    } else {
+      b.resolved = true;
+      b.definedBeforeUse = g.end !== -1 && g.end < b.start;
+      if (!b.definedBeforeUse) {
+        const label = `group ${g.index}${g.name ? ` ("${g.name}")` : ""}`;
+        issues.push({ severity: "error", message: `Backreference ${b.raw} at position ${b.start} references ${label}, which hasn't finished being defined yet at that point in the pattern.` });
+      }
+    }
+  }
+  return { pattern, valid, ...compileError ? { compileError } : {}, groups, backreferences, issues };
+}
+server.tool(
+  "analyze_regex_groups",
+  "Parse a regex pattern's capture groups (numbered and named) and backreferences, and flag any backreference pointing at a group that doesn't exist or hasn't finished being defined yet at that point in the pattern (a forward reference or self-reference). Structural, non-AI check. Pass the pattern body only, no delimiters or flags.",
+  { pattern: z.string().describe("The regex pattern body to analyze, e.g. (?<year>\\d{4})-(?<month>\\d{2})\\k<year>") },
+  async ({ pattern }) => {
+    const result = _analyzeRegexGroupsMcp(pattern);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 var _CC_NUM_FIELDS_MCP = ["maxAge", "sMaxAge", "staleWhileRevalidate", "staleIfError"];
 function _humanizeCacheSecondsMcp(s) {
   if (s === 0) return "0 seconds";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.66.0",
+  "version": "0.67.0",
   "description": "MCP server exposing 198 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",