@getmikk/mcp-server 1.9.0 → 1.9.1

package/bin/mikk-mcp.js

@@ -18,4 +18,13 @@ if (idx !== -1 && process.argv[idx + 1]) {
 process.env.MIKK_PROJECT_ROOT = projectRoot
 
 // Load the CJS bundle (auto-starts stdio server via src/index.ts)
-require('../dist/index.cjs')
+const mod = require('../dist/index.cjs')
+if (mod.startStdioServer) {
+    mod.startStdioServer().catch(err => {
+        console.error('Failed to start MCP server:', err)
+        process.exit(1)
+    })
+} else {
+    console.error('MCP server bundle is missing startStdioServer export.')
+    process.exit(1)
+}

package/dist/index.cjs

@@ -238659,6 +238659,38 @@ var IntentSchema = external_exports.object({
 // src/tools.ts
 var projectCache = /* @__PURE__ */ new Map();
 var CACHE_TTL_MS = 3e4;
+var _CPT = 4;
+var _ALC = 42;
+var _tallies = /* @__PURE__ */ new Map();
+function _tally(r) {
+  let t = _tallies.get(r);
+  if (!t) {
+    t = { calls: 0, used: 0, raw: 0, saved: 0, start: Date.now() };
+    _tallies.set(r, t);
+  }
+  return t;
+}
+function _tok(o) {
+  return Math.max(1, Math.round(JSON.stringify(o).length / _CPT));
+}
+function _fileTok(lock, fp) {
+  const fs22 = Object.values(lock.functions).filter((f) => f.file === fp);
+  const ln = fs22.length > 0 ? Math.max(...fs22.map((f) => f.endLine)) : 80;
+  return Math.round(ln * _ALC / _CPT);
+}
+function _filesTok(lock, fps) {
+  return fps.reduce((s, f) => s + _fileTok(lock, f), 0);
+}
+function _track(root, raw, resp) {
+  const used = _tok(resp);
+  const saved = Math.max(0, raw - used);
+  const t = _tally(root);
+  t.calls++;
+  t.used += used;
+  t.raw += raw;
+  t.saved += saved;
+  return { used, raw, saved, sessionSaved: t.saved, sessionCalls: t.calls };
+}
 var semanticSearchers = /* @__PURE__ */ new Map();
 function getSemanticSearcher(projectRoot) {
   let s = semanticSearchers.get(projectRoot);
@@ -238706,12 +238738,14 @@ function registerTools(server2, projectRoot) {
         warning: staleness,
         hint: "Next: Use mikk_query_context with your task description, or mikk_list_modules to explore the architecture."
       };
+      const _rawOverview = Math.min(15, Object.keys(lock.files).length) * Math.round(80 * _ALC / _CPT);
+      overview.tokens = _track(projectRoot, _rawOverview, overview);
       return { content: [{ type: "text", text: JSON.stringify(overview, null, 2) }] };
     }
   );
   server2.tool(
     "mikk_query_context",
-    "Ask an architecture question \u201D returns graph-traced context with relevant functions, files, and call chains. Use this to understand how code flows through the project.",
+    "Ask an architecture question \xC3\xA2\xE2\u201A\xAC\xC2\x9D returns graph-traced context with relevant functions, files, and call chains. Use this to understand how code flows through the project.",
     {
       question: external_exports.string().describe("The architecture question or task description"),
       maxHops: external_exports.number().optional().default(4).describe("Graph traversal depth (default: 4)"),
@@ -238748,8 +238782,14 @@ function registerTools(server2, projectRoot) {
       const warning = staleness ? `
 
 ${staleness}` : "";
+      const _rawQC = (tokenBudget ?? 6e3) * 3;
+      const _tokQC = _track(projectRoot, _rawQC, output);
+      const tokLine = `
+
+---
+// tokens: ${JSON.stringify(_tokQC)}`;
       return {
-        content: [{ type: "text", text: output + warning + "\n\n---\nHint: Use mikk_before_edit on any files you plan to modify, then mikk_impact_analysis to see the full blast radius." }]
+        content: [{ type: "text", text: output + warning + "\n\n---\nHint: Use mikk_before_edit on any files you plan to modify, then mikk_impact_analysis to see the full blast radius." + tokLine }]
       };
     }
   );
@@ -238802,6 +238842,8 @@ ${staleness}` : "";
         warning: staleness,
         hint: "Next: Use mikk_get_function_detail on critical/high items to review them. Then mikk_before_edit to validate your planned changes."
       };
+      const _rawIA = _fileTok(lock, normalizedFile) + result.impacted.length * Math.round(40 * _ALC / _CPT);
+      response.tokens = _track(projectRoot, _rawIA, response);
       return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
     }
   );
@@ -238911,8 +238953,10 @@ ${staleness}` : "";
         constraintStatus: totalViolations === 0 ? "pass" : "fail",
         files: fileReports,
         warning: staleness,
-        hint: totalViolations > 0 ? "\x8F Constraint violations detected! Review the violations before proceeding. Use mikk_get_constraints for full rule context." : "All constraints satisfied. If safe, proceed with your edits."
+        hint: totalViolations > 0 ? "\xC3\u201A\xC2\x8F Constraint violations detected! Review the violations before proceeding. Use mikk_get_constraints for full rule context." : "All constraints satisfied. If safe, proceed with your edits."
       };
+      const _rawBE = _filesTok(lock, filesToEdit) * 4;
+      response.tokens = _track(projectRoot, _rawBE, response);
       return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
     }
   );
@@ -239043,7 +239087,7 @@ ${staleness}` : "";
           content: [{
             type: "text",
             text: [
-              "\x9D\u0152 Semantic search requires @xenova/transformers.",
+              "\xC3\u201A\xC2\x9D\xC3\u2026\xE2\u20AC\u2122 Semantic search requires @xenova/transformers.",
               "",
               "Install it in your project root:",
               "  npm install @xenova/transformers",
@@ -239172,7 +239216,7 @@ ${content}`
   );
   server2.tool(
     "mikk_dead_code",
-    "Detect dead code \u201D functions with zero callers after exempting exports, entry points, route handlers, tests, and constructors. Use this before refactoring or cleanup.",
+    "Detect dead code \xC3\xA2\xE2\u201A\xAC\xC2\x9D functions with zero callers after exempting exports, entry points, route handlers, tests, and constructors. Use this before refactoring or cleanup.",
     {
       moduleId: external_exports.string().optional().describe("Filter results to a specific module ID")
     },
@@ -239197,7 +239241,7 @@ ${content}`
   );
   server2.tool(
     "mikk_manage_adr",
-    "CRUD for Architectural Decision Records (ADRs) in mikk.json. Actions: list, get, add, update, remove. WHEN TO USE: When making architectural changes \u2014 document WHY so future AI agents understand. AFTER THIS: ADRs automatically surface in mikk_query_context responses. Required for add: id, title, reason.",
+    "CRUD for Architectural Decision Records (ADRs) in mikk.json. Actions: list, get, add, update, remove. WHEN TO USE: When making architectural changes \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D document WHY so future AI agents understand. AFTER THIS: ADRs automatically surface in mikk_query_context responses. Required for add: id, title, reason.",
     {
       action: external_exports.enum(["list", "get", "add", "update", "remove"]).describe("The CRUD action to perform"),
       id: external_exports.string().optional().describe("ADR id (required for get, update, remove)"),
@@ -239300,12 +239344,14 @@ ${content}`
         warning: staleness,
         hint: modified.length + added.length > 0 ? "Run `mikk analyze` to update the lock file with these changes." : "Codebase is in sync with the lock file."
       };
+      const _rawGC = Math.min(50, Object.keys(lock.files).length) * Math.round(60 * _ALC / _CPT);
+      response.tokens = _track(projectRoot, _rawGC, response);
       return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
     }
   );
   server2.tool(
     "mikk_read_file",
-    "Read file scoped to specific functions. Returns bodies with metadata headers (params, calls, calledBy). WHEN TO USE: When you know which functions you need \u2014 saves tokens vs mikk_get_file. AFTER THIS: Use mikk_before_edit before making changes. TIP: This is the preferred way to read code \u2014 always specify function names when possible.",
+    "Read file scoped to specific functions. Returns bodies with metadata headers (params, calls, calledBy). WHEN TO USE: When you know which functions you need \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D saves tokens vs mikk_get_file. AFTER THIS: Use mikk_before_edit before making changes. TIP: This is the preferred way to read code \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D always specify function names when possible.",
     {
       file: external_exports.string().describe("File path relative to project root"),
       functions: external_exports.array(external_exports.string()).optional().describe("Function names to extract. If omitted, returns the whole file.")
@@ -239345,7 +239391,7 @@ ${content}` }]
           (f) => (f.name === fnName || f.name.endsWith(`.${fnName}`)) && (f.file === normalizedFile || f.file.endsWith("/" + normalizedFile))
         );
         if (!fn) {
-          sections.push(`// \x9D\u0152 Function "${fnName}" not found in ${file}`);
+          sections.push(`// \xC3\u201A\xC2\x9D\xC3\u2026\xE2\u20AC\u2122 Function "${fnName}" not found in ${file}`);
           continue;
         }
         const header = [
@@ -239368,7 +239414,10 @@ ${body}`);
       const warningText = staleness ? `
 
 ${staleness}` : "";
-      return { content: [{ type: "text", text: output + warningText }] };
+      const _rawRF = _fileTok(lock, file.replace(/\\/g, "/"));
+      const _tokRF = _track(projectRoot, _rawRF, output);
+      return { content: [{ type: "text", text: output + warningText + `
+// tokens: ${JSON.stringify(_tokRF)}` }] };
     }
   );
   server2.tool(
@@ -239432,6 +239481,8 @@ ${staleness}` : "";
         warning: staleness,
         hint: changedCount > 0 ? `${changedCount} file(s) may have changed. Run \`mikk analyze\` for accurate results, or use mikk_get_changes for details.` : "Codebase is in sync. Use mikk_query_context with your task description to get started."
       };
+      const _rawSC = Math.min(20, Object.keys(lock.files).length) * Math.round(100 * _ALC / _CPT);
+      response.tokens = _track(projectRoot, _rawSC, response);
       return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
     }
   );
@@ -239480,7 +239531,7 @@ ${staleness}` : "";
   );
   server2.tool(
     "mikk_rename",
-    "Plan a coordinated multi-file rename. Finds all call sites and import locations for a function and provides a step-by-step edit plan. WHEN TO USE: Before renaming any function \u2014 ensures you update ALL call sites. AFTER THIS: Execute the edit plan, then run mikk analyze.",
+    "Plan a coordinated multi-file rename. Finds all call sites and import locations for a function and provides a step-by-step edit plan. WHEN TO USE: Before renaming any function \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D ensures you update ALL call sites. AFTER THIS: Execute the edit plan, then run mikk analyze.",
     {
       functionName: external_exports.string().describe("The current function name to rename"),
       newName: external_exports.string().describe("The desired new name")
@@ -239536,6 +239587,37 @@ ${staleness}` : "";
       };
     }
   );
+  server2.tool(
+    "mikk_token_stats",
+    "Show token savings for this session \u2014 how many tokens Mikk saved vs. the agent reading raw source files. WHEN TO USE: Any time. Useful at end of session to see cumulative efficiency. Returns per-session totals and cost estimates.",
+    {},
+    async () => {
+      const t = _tally(projectRoot);
+      const { lock } = await loadContractAndLock(projectRoot);
+      const totalFileLine = Object.values(lock.functions).reduce((s, f) => s + (f.endLine - f.startLine + 1), 0);
+      const fullCodebaseTok = Math.round(totalFileLine * _ALC / _CPT);
+      const elapsedMin = Math.round((Date.now() - t.start) / 6e4);
+      const response = {
+        session: {
+          calls: t.calls,
+          elapsedMinutes: elapsedMin
+        },
+        tokens: {
+          used: t.used,
+          rawWouldHaveCost: t.raw,
+          saved: t.saved,
+          savingsPercent: t.raw > 0 ? Math.round(t.saved / t.raw * 100) : 0
+        },
+        context: {
+          fullCodebaseTokens: fullCodebaseTok,
+          percentOfCodebaseRead: t.raw > 0 ? Math.round(t.used / fullCodebaseTok * 100) : 0,
+          note: "Full codebase = if agent read every tracked source line once"
+        },
+        interpretation: t.saved > 0 ? `Mikk saved ~${t.saved.toLocaleString()} tokens this session (${Math.round(t.saved / t.raw * 100)}% reduction). Roughly ${Math.round(t.saved / 1e3)}k tokens = ~${(t.saved * 3e-6).toFixed(3)} USD at GPT-4o rates.` : "No tools called yet this session."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+    }
+  );
 }
 async function loadContractAndLock(projectRoot) {
   const cached2 = projectCache.get(projectRoot);
@@ -239549,7 +239631,7 @@ async function loadContractAndLock(projectRoot) {
   const syncStatus = lock.syncState?.status ?? "unknown";
   let staleness = null;
   if (syncStatus === "drifted" || syncStatus === "conflict") {
-    staleness = `\x8F Lock file is ${syncStatus}. Run \`mikk analyze\` for accurate results.`;
+    staleness = `\xC3\u201A\xC2\x8F Lock file is ${syncStatus}. Run \`mikk analyze\` for accurate results.`;
   }
   if (!staleness) {
     const fileEntries = Object.entries(lock.files);
@@ -239572,7 +239654,7 @@ async function loadContractAndLock(projectRoot) {
       }
     }
     if (mismatched > 0) {
-      staleness = `\x8F STALE: ${mismatched} file(s) changed since last analysis (${mismatchedFiles.slice(0, 3).join(", ")}${mismatched > 3 ? "..." : ""}). Run \`mikk analyze\`.`;
+      staleness = `\xC3\u201A\xC2\x8F STALE: ${mismatched} file(s) changed since last analysis (${mismatchedFiles.slice(0, 3).join(", ")}${mismatched > 3 ? "..." : ""}). Run \`mikk analyze\`.`;
     }
   }
   const graph = buildGraphFromLock(lock);
@@ -239644,7 +239726,7 @@ function detectCircularDeps(fns, lock) {
         const cycleStart = cyclePath.indexOf(id);
         const cycle = cyclePath.slice(cycleStart).map((cid) => lock.functions[cid]?.name ?? cid);
         cycle.push(lock.functions[id]?.name ?? id);
-        warnings.push(`\x8F Circular: ${cycle.join(" \u2020\u2019 ")}`);
+        warnings.push(`\xC3\u201A\xC2\x8F Circular: ${cycle.join(" \xC3\xA2\xE2\u201A\xAC\xC2\xA0\xC3\xA2\xE2\u201A\xAC\xE2\u201E\xA2 ")}`);
         return true;
       }
       if (visited.has(id)) return false;
@@ -239779,7 +239861,7 @@ async function safeRead(filePath) {
 }
 
 // src/server.ts
-var VERSION = true ? "1.9.0" : "0.0.0-dev";
+var VERSION = true ? "1.9.1" : "0.0.0-dev";
 function createMikkMcpServer(projectRoot) {
   const server2 = new McpServer({
     name: "mikk",
@@ -239889,9 +239971,6 @@ async function startStdioServer() {
   const transport = new StdioServerTransport();
   await server2.connect(transport);
 }
-
-// src/index.ts
-startStdioServer();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createMikkMcpServer,