@utilix-tech/mcp 0.88.0 → 0.89.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.89.0
+- Add `check_acronym_expansion` tool: scan text for acronyms and flag any used before being expanded on first mention, recognizing both the "full term (ACRONYM)" and "ACRONYM (full term)" conventions, with acronyms never expanded anywhere reported separately.
+
 ## 0.88.0
 - Add `validate_mermaid_syntax` tool: check a Mermaid diagram definition for syntax errors with line numbers, including an unterminated subgraph, unbalanced node brackets, a malformed edge arrow, and a sequence-diagram participant referenced before its explicit declaration.
 - Add `calculate_annuity_payout` tool: solve the standard annuity formula in either direction, the periodic payout a lump sum funds, or the lump sum required to fund a target payout, for an ordinary or annuity-due structure.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 269 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 270 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.
 
@@ -134,7 +134,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `generate_random_data` | Generate random mock data: names, emails, UUIDs, IPs, etc. |
 | `generate_csp_nonce` | Generate a cryptographically random CSP nonce with ready-to-paste header directive and script/style tag snippets |
 
-### Text (17 tools)
+### Text (18 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_case` | Convert text case: camelCase, snake_case, PascalCase, etc. |
@@ -156,6 +156,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `lookup_emoji` | Search a curated table of ~280 common emoji by name, keyword, or GitHub-style shortcode, or look one up exactly by shortcode, character, or category |
 | `analyze_keyword_density` | Count keyword/phrase frequency and density (occurrences per 100 words) across a block of text, with single-word or 2/3-word phrase modes |
 | `check_dash_usage` | Scan text for likely dash misuse: a hyphen surrounded by spaces, an unconverted double hyphen, and inconsistent spacing around em dashes across the same document |
+| `check_acronym_expansion` | Scan text for acronyms and flag any that are used before being expanded on first mention, or never expanded at all |
 
 ### Time (6 tools)
 | Tool | Description |

package/dist/index.js

@@ -13944,6 +13944,76 @@ server.tool(
     return text(JSON.stringify(_checkDashUsageMcp(input), null, 2));
   }
 );
+var _ACRONYM_TOKEN_RE_MCP = /\b[A-Z][A-Z0-9]{1,9}\b/g;
+var _ACRONYM_IN_PARENS_RE_MCP = /\(([A-Z][A-Z0-9]{1,9})\)/g;
+var _ACRONYM_THEN_EXPANSION_RE_MCP = /\b([A-Z][A-Z0-9]{1,9})\b\s*\(([a-zA-Z][^()]{1,100})\)/g;
+function _acronymContextSnippetMcp(input, index, matchLen) {
+  const start = Math.max(0, index - 25);
+  const end = Math.min(input.length, index + matchLen + 25);
+  const body = input.slice(start, end).replace(/\s+/g, " ").trim();
+  return (start > 0 ? "\u2026" : "") + body + (end < input.length ? "\u2026" : "");
+}
+function _checkAcronymExpansionMcp(input) {
+  const definedAt = /* @__PURE__ */ new Map();
+  for (const m of input.matchAll(_ACRONYM_IN_PARENS_RE_MCP)) {
+    const acronym = m[1];
+    const idx = (m.index ?? 0) + 1;
+    const existing = definedAt.get(acronym);
+    if (existing === void 0 || idx < existing) definedAt.set(acronym, idx);
+  }
+  for (const m of input.matchAll(_ACRONYM_THEN_EXPANSION_RE_MCP)) {
+    const acronym = m[1];
+    const idx = m.index ?? 0;
+    const existing = definedAt.get(acronym);
+    if (existing === void 0 || idx < existing) definedAt.set(acronym, idx);
+  }
+  const occurrencesByAcronym = /* @__PURE__ */ new Map();
+  for (const m of input.matchAll(_ACRONYM_TOKEN_RE_MCP)) {
+    const acronym = m[0];
+    const idx = m.index ?? 0;
+    const list = occurrencesByAcronym.get(acronym);
+    if (list) list.push(idx);
+    else occurrencesByAcronym.set(acronym, [idx]);
+  }
+  const acronyms = [];
+  const issues = [];
+  for (const [acronym, indicesUnsorted] of occurrencesByAcronym) {
+    const indices = [...indicesUnsorted].sort((a, b) => a - b);
+    const firstUsedAt = indices[0];
+    const expandedAt = definedAt.has(acronym) ? definedAt.get(acronym) : null;
+    const earlyUse = expandedAt !== null ? indices.find((i) => i < expandedAt) : void 0;
+    const usedBeforeExpansion = earlyUse !== void 0;
+    acronyms.push({ acronym, occurrences: indices.length, firstUsedAt, expandedAt, usedBeforeExpansion });
+    if (usedBeforeExpansion) {
+      issues.push({
+        type: "used-before-expansion",
+        acronym,
+        index: earlyUse,
+        context: _acronymContextSnippetMcp(input, earlyUse, acronym.length),
+        message: `"${acronym}" is used here before it's expanded later in the document (at character ${expandedAt}).`
+      });
+    } else if (expandedAt === null) {
+      issues.push({
+        type: "never-expanded",
+        acronym,
+        index: firstUsedAt,
+        context: _acronymContextSnippetMcp(input, firstUsedAt, acronym.length),
+        message: `"${acronym}" is never expanded anywhere in this document.`
+      });
+    }
+  }
+  acronyms.sort((a, b) => a.firstUsedAt - b.firstUsedAt);
+  issues.sort((a, b) => a.index - b.index);
+  return { acronyms, issues };
+}
+server.tool(
+  "check_acronym_expansion",
+  "Scan text for acronyms (2-10 character all-caps tokens) and flag any that are used before being expanded on first mention, per standard technical writing style guides. Recognizes both expansion conventions: the full term followed by the acronym in parentheses, and the acronym followed by its expansion in parentheses. Pure regex heuristic, not a dictionary of real acronyms.",
+  { text: z.string().describe("The text to scan for acronym expansion order") },
+  async ({ text: input }) => {
+    return text(JSON.stringify(_checkAcronymExpansionMcp(input), null, 2));
+  }
+);
 var _CommissionTierSchema = z.object({
   upTo: z.number().nullable().describe("Upper bound of this tier (exclusive). null means unbounded and is only valid on the last tier."),
   ratePercent: z.number().min(0).describe("Commission rate as a percent applied to the slice of salesAmount within this tier")

package/package.json

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