v1.6.0: Add vitest test suite (106 tests) and extract format utils

Add comprehensive test coverage across all modules using vitest.
Extract formatting functions from src/index.ts to src/utils/format.ts
for testability. Tests run as prepublish guard.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: critesjosh

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "aztec-mcp-server",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "description": "MCP server for Aztec development - clones and searches Aztec documentation and examples",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,9 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm test && npm run build"
   },
   "keywords": [
     "aztec",
@@ -30,12 +32,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "simple-git": "^3.27.0",
-    "globby": "^14.0.2"
+    "globby": "^14.0.2",
+    "simple-git": "^3.27.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
   },
   "engines": {
     "node": ">=18.0.0"

package.json

@@ -24,6 +24,14 @@ import {
   readAztecExample,
   readRepoFile,
 } from "./tools/index.js";
+import {
+  formatSyncResult,
+  formatStatus,
+  formatSearchResults,
+  formatExamplesList,
+  formatExampleContent,
+  formatFileContent,
+} from "./utils/format.js";
 
 const server = new Server(
   {
@@ -316,127 +324,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   }
 });
 
-// --- Formatting helpers ---
-
-function formatSyncResult(result: Awaited<ReturnType<typeof syncRepos>>): string {
-  const lines = [
-    result.success ? "✓ Sync completed" : "⚠ Sync completed with errors",
-    "",
-    `Version: ${result.version}`,
-    result.message,
-    "",
-    "Repositories:",
-  ];
-
-  for (const repo of result.repos) {
-    const icon = repo.status.toLowerCase().includes("error") ? "✗" : "✓";
-    lines.push(`  ${icon} ${repo.name}: ${repo.status}`);
-  }
-
-  return lines.join("\n");
-}
-
-function formatStatus(status: Awaited<ReturnType<typeof getStatus>>): string {
-  const lines = [
-    "Aztec MCP Server Status",
-    "",
-    `Repos directory: ${status.reposDir}`,
-    "",
-    "Repositories:",
-  ];
-
-  for (const repo of status.repos) {
-    const icon = repo.cloned ? "✓" : "○";
-    const commit = repo.commit ? ` (${repo.commit})` : "";
-    lines.push(`  ${icon} ${repo.name}${commit}`);
-    lines.push(`    ${repo.description}`);
-  }
-
-  const clonedCount = status.repos.filter((r) => r.cloned).length;
-  if (clonedCount === 0) {
-    lines.push("");
-    lines.push("No repositories cloned. Run aztec_sync_repos to get started.");
-  }
-
-  return lines.join("\n");
-}
-
-function formatSearchResults(
-  result: ReturnType<typeof searchAztecCode>
-): string {
-  const lines = [result.message, ""];
-
-  if (!result.success || result.results.length === 0) {
-    return lines.join("\n");
-  }
-
-  for (const match of result.results) {
-    lines.push(`**${match.file}:${match.line}**`);
-    lines.push("```");
-    lines.push(match.content);
-    lines.push("```");
-    lines.push("");
-  }
-
-  return lines.join("\n");
-}
-
-function formatExamplesList(
-  result: ReturnType<typeof listAztecExamples>
-): string {
-  const lines = [result.message, ""];
-
-  if (!result.success || result.examples.length === 0) {
-    return lines.join("\n");
-  }
-
-  // Group by repo
-  const byRepo = new Map<string, typeof result.examples>();
-  for (const example of result.examples) {
-    if (!byRepo.has(example.repo)) {
-      byRepo.set(example.repo, []);
-    }
-    byRepo.get(example.repo)!.push(example);
-  }
-
-  for (const [repo, examples] of byRepo) {
-    lines.push(`**${repo}:**`);
-    for (const example of examples) {
-      lines.push(`  - ${example.name}`);
-    }
-    lines.push("");
-  }
-
-  return lines.join("\n");
-}
-
-function formatExampleContent(
-  result: ReturnType<typeof readAztecExample>
-): string {
-  if (!result.success || !result.content) {
-    return result.message;
-  }
-
-  const lines = [
-    `**${result.example!.name}** (${result.example!.repo})`,
-    `Path: ${result.example!.path}`,
-    "",
-    "```noir",
-    result.content,
-    "```",
-  ];
-
-  return lines.join("\n");
-}
-
-function formatFileContent(result: ReturnType<typeof readRepoFile>): string {
-  if (!result.success || !result.content) {
-    return result.message;
-  }
-
-  return result.content;
-}
-
 // --- Start server ---
 
 async function main() {

src/index.ts

@@ -0,0 +1,144 @@
+/**
+ * Formatting utilities for MCP tool responses
+ */
+
+import type { SyncResult } from "../tools/sync.js";
+import type { SearchResult, FileInfo } from "./search.js";
+
+export function formatSyncResult(result: SyncResult): string {
+  const lines = [
+    result.success ? "✓ Sync completed" : "⚠ Sync completed with errors",
+    "",
+    `Version: ${result.version}`,
+    result.message,
+    "",
+    "Repositories:",
+  ];
+
+  for (const repo of result.repos) {
+    const icon = repo.status.toLowerCase().includes("error") ? "✗" : "✓";
+    lines.push(`  ${icon} ${repo.name}: ${repo.status}`);
+  }
+
+  return lines.join("\n");
+}
+
+export function formatStatus(status: {
+  reposDir: string;
+  repos: {
+    name: string;
+    description: string;
+    cloned: boolean;
+    commit?: string;
+  }[];
+}): string {
+  const lines = [
+    "Aztec MCP Server Status",
+    "",
+    `Repos directory: ${status.reposDir}`,
+    "",
+    "Repositories:",
+  ];
+
+  for (const repo of status.repos) {
+    const icon = repo.cloned ? "✓" : "○";
+    const commit = repo.commit ? ` (${repo.commit})` : "";
+    lines.push(`  ${icon} ${repo.name}${commit}`);
+    lines.push(`    ${repo.description}`);
+  }
+
+  const clonedCount = status.repos.filter((r) => r.cloned).length;
+  if (clonedCount === 0) {
+    lines.push("");
+    lines.push("No repositories cloned. Run aztec_sync_repos to get started.");
+  }
+
+  return lines.join("\n");
+}
+
+export function formatSearchResults(result: {
+  success: boolean;
+  results: SearchResult[];
+  message: string;
+}): string {
+  const lines = [result.message, ""];
+
+  if (!result.success || result.results.length === 0) {
+    return lines.join("\n");
+  }
+
+  for (const match of result.results) {
+    lines.push(`**${match.file}:${match.line}**`);
+    lines.push("```");
+    lines.push(match.content);
+    lines.push("```");
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+export function formatExamplesList(result: {
+  success: boolean;
+  examples: FileInfo[];
+  message: string;
+}): string {
+  const lines = [result.message, ""];
+
+  if (!result.success || result.examples.length === 0) {
+    return lines.join("\n");
+  }
+
+  // Group by repo
+  const byRepo = new Map<string, FileInfo[]>();
+  for (const example of result.examples) {
+    if (!byRepo.has(example.repo)) {
+      byRepo.set(example.repo, []);
+    }
+    byRepo.get(example.repo)!.push(example);
+  }
+
+  for (const [repo, examples] of byRepo) {
+    lines.push(`**${repo}:**`);
+    for (const example of examples) {
+      lines.push(`  - ${example.name}`);
+    }
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+export function formatExampleContent(result: {
+  success: boolean;
+  example?: FileInfo;
+  content?: string;
+  message: string;
+}): string {
+  if (!result.success || !result.content) {
+    return result.message;
+  }
+
+  const lines = [
+    `**${result.example!.name}** (${result.example!.repo})`,
+    `Path: ${result.example!.path}`,
+    "",
+    "```noir",
+    result.content,
+    "```",
+  ];
+
+  return lines.join("\n");
+}
+
+export function formatFileContent(result: {
+  success: boolean;
+  content?: string;
+  message: string;
+}): string {
+  if (!result.success || !result.content) {
+    return result.message;
+  }
+
+  return result.content;
+}