@utilix-tech/mcp 0.68.0 → 0.69.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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.69.0
+- Add `parse_commit_trailers` tool: parse a commit message's trailer block (Co-authored-by, Signed-off-by, Fixes, Reviewed-by, etc.) per git's RFC 822-style trailer convention, returning each trailer's key and value plus the body with the trailer block removed.
+- Add `extract_markdown_footnotes` tool: extract every Markdown-Extra-style footnote reference and definition from a document, flagging references with no matching definition and definitions that are never referenced.
+
 ## 0.68.0
 - Add `build_robots_meta_tag`, `parse_robots_meta_tag` tools: build a `<meta name="robots" content="...">` tag from the same directive vocabulary as X-Robots-Tag, optionally scoped to a crawler via the name attribute, or parse an existing tag into the same shape.
 - Add `extract_svg_sprite_symbols` tool: parse an SVG sprite sheet's `<symbol>` definitions and list each one's id, viewBox, width, and height, alongside a ready-to-paste `<use href="#id"></use>` usage snippet.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 231 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 233 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.
 
@@ -265,7 +265,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `color_palette` | Generate a color palette from a base color |
 | `color_shades` | Generate shades or tints from a base color |
 
-### Code (18 tools)
+### Code (20 tools)
 | Tool | Description |
 |------|-------------|
 | `format_sql` | Format a SQL query with proper indentation |
@@ -286,6 +286,8 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `validate_package_exports` | Validate a package.json "exports" field: dual-package (ESM/CJS) misconfigurations like a missing default fallback or a require/import pointing at the wrong extension |
 | `audit_dependency_ranges` | Classify each package.json dependency's version range type and flag wildcard ranges, the "latest" tag, git/URL/file/link dependencies, and packages listed with conflicting or redundant ranges across sections |
 | `extract_svg_sprite_symbols` | Parse an SVG sprite sheet's `<symbol>` definitions and list each one's id, viewBox, width, and height, alongside a ready-to-paste `<use href="#id"></use>` usage snippet |
+| `parse_commit_trailers` | Parse a commit message's trailer block (Co-authored-by, Signed-off-by, Fixes, Reviewed-by, etc.) per git's RFC 822-style trailer convention, returning each trailer's key/value plus the body with the trailer block removed |
+| `extract_markdown_footnotes` | Extract every Markdown-Extra-style footnote reference and definition from a document, flagging references with no matching definition and definitions that are never referenced |
 
 ### Data (16 tools)
 | Tool | Description |

package/dist/index.js

@@ -11010,5 +11010,115 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+var _TRAILER_LINE_REGEX_MCP = /^([A-Za-z][A-Za-z0-9-]*): (.+)$/;
+var _TRAILER_CONTINUATION_REGEX_MCP = /^[ \t]+\S/;
+function _parseCommitTrailersMcp(message) {
+  const lines = message.replace(/\r\n/g, "\n").split("\n");
+  while (lines.length > 0 && lines[lines.length - 1].trim() === "") lines.pop();
+  if (lines.length === 0) return { error: "Empty input" };
+  let start = 0;
+  for (let i = lines.length - 1; i >= 0; i--) {
+    if (lines[i].trim() === "") {
+      start = i + 1;
+      break;
+    }
+  }
+  const paragraph = lines.slice(start);
+  const trailers = [];
+  let valid = true;
+  for (const line of paragraph) {
+    const m = line.match(_TRAILER_LINE_REGEX_MCP);
+    if (m) {
+      trailers.push({ key: m[1], value: m[2].trim() });
+    } else if (_TRAILER_CONTINUATION_REGEX_MCP.test(line) && trailers.length > 0) {
+      trailers[trailers.length - 1].value += " " + line.trim();
+    } else {
+      valid = false;
+      break;
+    }
+  }
+  if (!valid || trailers.length === 0) {
+    return { trailers: [], body: lines.join("\n").trim(), hasTrailers: false };
+  }
+  const body = lines.slice(0, start).join("\n").trim();
+  return { trailers, body, hasTrailers: true };
+}
+server.tool(
+  "parse_commit_trailers",
+  `Parse a commit message's trailer block (Co-authored-by, Signed-off-by, Fixes, Reviewed-by, etc.) per git's RFC 822-style trailer convention (git-interpret-trailers): the last paragraph of the message, where every line is either a "Key: value" pair or an indented continuation of the previous trailer's value. Returns the trailers plus the message body with the trailer block removed.`,
+  {
+    message: z.string().min(1).describe("The full commit message")
+  },
+  async ({ message }) => {
+    const result = _parseCommitTrailersMcp(message);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
+var _FOOTNOTE_DEFINITION_LINE_REGEX_MCP = /^\[\^([^\]]+)\]:\s?(.*)$/;
+var _FOOTNOTE_CONTINUATION_REGEX_MCP = /^(?: {4}|\t)/;
+var _FOOTNOTE_REFERENCE_REGEX_MCP = /\[\^([^\]]+)\]/g;
+function _extractMarkdownFootnotesMcp(markdown) {
+  const trimmed = markdown.trim();
+  if (!trimmed) return { error: "Empty input" };
+  if (!trimmed.includes("[^")) return { error: "No footnote references or definitions found" };
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const definitions = [];
+  const definedLabels = /* @__PURE__ */ new Set();
+  const consumed = new Array(lines.length).fill(false);
+  let i = 0;
+  while (i < lines.length) {
+    const match = lines[i].match(_FOOTNOTE_DEFINITION_LINE_REGEX_MCP);
+    if (!match) {
+      i++;
+      continue;
+    }
+    const label = match[1];
+    const textLines = [match[2]];
+    consumed[i] = true;
+    let j = i + 1;
+    while (j < lines.length && (_FOOTNOTE_CONTINUATION_REGEX_MCP.test(lines[j]) || lines[j].trim() === "" && j + 1 < lines.length && _FOOTNOTE_CONTINUATION_REGEX_MCP.test(lines[j + 1]))) {
+      textLines.push(lines[j].trim() === "" ? "" : lines[j].replace(_FOOTNOTE_CONTINUATION_REGEX_MCP, ""));
+      consumed[j] = true;
+      j++;
+    }
+    if (!definedLabels.has(label)) {
+      definedLabels.add(label);
+      definitions.push({ label, text: textLines.join("\n").trim() });
+    }
+    i = j;
+  }
+  const referenceScanText = lines.filter((_, idx) => !consumed[idx]).join("\n");
+  const refOrder = [];
+  const refCounts = /* @__PURE__ */ new Map();
+  for (const m of referenceScanText.matchAll(_FOOTNOTE_REFERENCE_REGEX_MCP)) {
+    const label = m[1];
+    if (!refCounts.has(label)) {
+      refCounts.set(label, 0);
+      refOrder.push(label);
+    }
+    refCounts.set(label, (refCounts.get(label) ?? 0) + 1);
+  }
+  const references = refOrder.map((label) => ({ label, count: refCounts.get(label) ?? 0 }));
+  const referencedSet = new Set(refOrder);
+  const unresolvedReferences = refOrder.filter((label) => !definedLabels.has(label));
+  const unusedDefinitions = definitions.filter((d) => !referencedSet.has(d.label)).map((d) => d.label);
+  const referenceCount = refOrder.reduce((sum, label) => sum + (refCounts.get(label) ?? 0), 0);
+  if (definitions.length === 0 && references.length === 0) {
+    return { error: "No footnote references or definitions found" };
+  }
+  return { definitionCount: definitions.length, referenceCount, definitions, references, unresolvedReferences, unusedDefinitions };
+}
+server.tool(
+  "extract_markdown_footnotes",
+  "Extract every Markdown-Extra-style footnote reference ([^label]) and definition ([^label]: text, with 4-space/tab-indented continuation lines) from a document, then flag references with no matching definition and definitions that are never referenced.",
+  {
+    markdown: z.string().min(1).describe("The Markdown document text")
+  },
+  async ({ markdown }) => {
+    const result = _extractMarkdownFootnotesMcp(markdown);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 var transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.68.0",
+  "version": "0.69.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",