feat: ask cursor to get filename

tewarig · tewarig · commit 69c4ea29f2bf · 2025-11-03T19:27:47.000+05:30
diff --git a/packages/blade-mcp/src/tools/createBladeCursorRules.ts b/packages/blade-mcp/src/tools/createBladeCursorRules.ts
@@ -14,7 +14,7 @@ import { handleError, sendAnalytics } from '../utils/analyticsUtils.js';
 const createBladeCursorRulesToolName = 'create_blade_cursor_rules';
 
 const createBladeCursorRulesToolDescription =
-  'Creates the cursor rules for blade to help with code generation. Returns the cursor rules file content that should be created. Call this before get_blade_docs and while creating a new blade project (only when using cursor and when the frontend-blade-rules-v{version}.mdc rule does not already exist).';
+  'Creates the cursor rules for blade to help with code generation. Returns the cursor rules file content that should be created. Call this before get_blade_docs and while creating a new blade project (only when using cursor and when the frontend-blade-rules.mdc rule does not already exist).';
 
 const createBladeCursorRulesToolSchema = {
   currentProjectRootDirectory: z
@@ -57,9 +57,8 @@ const createBladeCursorRulesToolCallback: ToolCallback<typeof createBladeCursorR
 
 **Instructions:**
 1. Create the directory if it doesn't exist: \`.cursor/rules/\`
-2. Create a new file named \`${cursorRulesFileName}\` in that directory .
-3. if their is any other file with name frontend-blade-rules-v{version}.mdc delete it first and create a new file. it should only have 1 file with frontend-blade-rules
-4. Copy the content below into the file
+2. Create a new file named \`${cursorRulesFileName}\` in that directory.
+3. Copy the content below into the file
 
 **Cursor Rules Version:** ${CURSOR_RULES_VERSION}
 
diff --git a/packages/blade-mcp/src/tools/getBladeComponentDocs.ts b/packages/blade-mcp/src/tools/getBladeComponentDocs.ts
@@ -1,7 +1,7 @@
 import { basename } from 'path';
 import { z } from 'zod';
 import type { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { analyticsToolCallEventName, getCursorRulesFileName } from '../utils/tokens.js';
+import { analyticsToolCallEventName, CURSOR_RULES_VERSION } from '../utils/tokens.js';
 import { getBladeDocsList } from '../utils/generalUtils.js';
 import { handleError, sendAnalytics } from '../utils/analyticsUtils.js';
 
@@ -26,18 +26,18 @@ const getBladeComponentDocsToolSchema = {
       "The working root directory of the consumer's project. Do not use root directory, do not use '.', only use absolute path to current directory",
     ),
   clientName: z.enum(['claude', 'cursor', 'unknown']).default('unknown'),
-  cursorRuleFileName: z
+  cursorRuleVersion: z
     .string()
     .describe(
-      'get the name of blade cursor rules file. You can use grep to find it: `grep -l "rules_version:" .cursor/rules/*.mdc` or search for files matching `frontend-blade-rules-v*.mdc` in `.cursor/rules/` directory and then trim the string for the last name and the .mdc extension (e.g., "frontend-blade-rules-v0.0.8"). if nothing is found send 0',
+      'get the version from the blade cursor rules file. The file should be named `frontend-blade-rules.mdc` in `.cursor/rules/` directory. Extract the version from the `rules_version:` field at the start of the file (e.g., "0.0.8"). If the file does not exist, send 0',
     ),
 };
 
 const getBladeComponentDocsToolCallback: ToolCallback<typeof getBladeComponentDocsToolSchema> = ({
   componentsList,
   currentProjectRootDirectory,
   clientName,
-  cursorRuleFileName,
+  cursorRuleVersion,
 }) => {
   const components = componentsList.split(',').map((s) => s.trim());
   const invalidComponents = components.filter((comp) => !bladeComponentsList.includes(comp));
@@ -49,18 +49,17 @@ const getBladeComponentDocsToolCallback: ToolCallback<typeof getBladeComponentDo
     });
   }
 
-  if (cursorRuleFileName === '0' && clientName === 'cursor') {
+  if (cursorRuleVersion === '0' && clientName === 'cursor') {
     return handleError({
       toolName: getBladeComponentDocsToolName,
       mcpErrorMessage: `Cursor rules do not exist. Call \`${createBladeCursorRulesToolName}\` first.`,
     });
   }
 
-  const expectedFileName = getCursorRulesFileName().replace('.mdc', '');
-  if (cursorRuleFileName !== expectedFileName && clientName === 'cursor') {
+  if (cursorRuleVersion !== CURSOR_RULES_VERSION && clientName === 'cursor') {
     return handleError({
       toolName: getBladeComponentDocsToolName,
-      mcpErrorMessage: `Cursor rules are outdated. Expected file name: ${expectedFileName}.mdc. Call \`${createBladeCursorRulesToolName}\` first to update cursor rules`,
+      mcpErrorMessage: `Cursor rules are outdated. Expected version: ${CURSOR_RULES_VERSION}. Current version: ${cursorRuleVersion}. Call \`${createBladeCursorRulesToolName}\` first to update cursor rules`,
     });
   }
 
diff --git a/packages/blade-mcp/src/tools/getBladeGeneralDocs.ts b/packages/blade-mcp/src/tools/getBladeGeneralDocs.ts
@@ -5,7 +5,7 @@ import type { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
 import {
   analyticsToolCallEventName,
   GENERAL_KNOWLEDGEBASE_DIRECTORY,
-  getCursorRulesFileName,
+  CURSOR_RULES_VERSION,
 } from '../utils/tokens.js';
 
 import { getBladeDocsList } from '../utils/generalUtils.js';
@@ -38,18 +38,18 @@ const getBladeGeneralDocsToolSchema = {
       "The working root directory of the consumer's project. Do not use root directory, do not use '.', only use absolute path to current directory",
     ),
   clientName: z.enum(['claude', 'cursor', 'unknown']).default('unknown'),
-  cursorRuleFileName: z
+  cursorRuleVersion: z
     .string()
     .describe(
-      'get the name of blade cursor rules file. You can use grep to find it: `grep -l "rules_version:" .cursor/rules/*.mdc` or search for files matching `frontend-blade-rules-v*.mdc` in `.cursor/rules/` directory and then trim the string for the last name and the .mdc extension (e.g., "frontend-blade-rules-v0.0.8"). if nothing is found send 0',
+      'get the version from the blade cursor rules file. The file should be named `frontend-blade-rules.mdc` in `.cursor/rules/` directory. Extract the version from the `rules_version:` field at the start of the file (e.g., "0.0.8"). If the file does not exist, send 0',
     ),
 };
 
 const getBladeGeneralDocsToolCallback: ToolCallback<typeof getBladeGeneralDocsToolSchema> = ({
   topicsList,
   currentProjectRootDirectory,
   clientName,
-  cursorRuleFileName,
+  cursorRuleVersion,
 }) => {
   const topics = topicsList.split(',').map((s) => s.trim());
   const invalidTopics = topics.filter((topic) => !bladeGeneralDocsList.includes(topic));
@@ -62,18 +62,17 @@ const getBladeGeneralDocsToolCallback: ToolCallback<typeof getBladeGeneralDocsTo
     });
   }
 
-  if (cursorRuleFileName === '0' && clientName === 'cursor') {
+  if (cursorRuleVersion === '0' && clientName === 'cursor') {
     return handleError({
       toolName: getBladeGeneralDocsToolName,
       mcpErrorMessage: `Cursor rules do not exist. Call \`${createBladeCursorRulesToolName}\` first.`,
     });
   }
 
-  const expectedFileName = getCursorRulesFileName().replace('.mdc', '');
-  if (cursorRuleFileName !== expectedFileName && clientName === 'cursor') {
+  if (cursorRuleVersion !== CURSOR_RULES_VERSION && clientName === 'cursor') {
     return handleError({
       toolName: getBladeGeneralDocsToolName,
-      mcpErrorMessage: `Cursor rules are outdated. Expected file name: ${expectedFileName}.mdc. Call \`${createBladeCursorRulesToolName}\` first to update cursor rules`,
+      mcpErrorMessage: `Cursor rules are outdated. Expected version: ${CURSOR_RULES_VERSION}. Current version: ${cursorRuleVersion}. Call \`${createBladeCursorRulesToolName}\` first to update cursor rules`,
     });
   }
 
diff --git a/packages/blade-mcp/src/tools/getBladePatternDocs.ts b/packages/blade-mcp/src/tools/getBladePatternDocs.ts
@@ -5,7 +5,7 @@ import type { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
 import {
   analyticsToolCallEventName,
   PATTERNS_KNOWLEDGEBASE_DIRECTORY,
-  getCursorRulesFileName,
+  CURSOR_RULES_VERSION,
 } from '../utils/tokens.js';
 
 import { getBladeDocsList } from '../utils/generalUtils.js';
@@ -38,18 +38,18 @@ const getBladePatternDocsToolSchema = {
       "The working root directory of the consumer's project. Do not use root directory, do not use '.', only use absolute path to current directory",
     ),
   clientName: z.enum(['claude', 'cursor', 'unknown']).default('unknown'),
-  cursorRuleFileName: z
+  cursorRuleVersion: z
     .string()
     .describe(
-      'get the name of blade cursor rules file. You can use grep to find it: `grep -l "rules_version:" .cursor/rules/*.mdc` or search for files matching `frontend-blade-rules-v*.mdc` in `.cursor/rules/` directory and then trim the string for the last name and the .mdc extension (e.g., "frontend-blade-rules-v0.0.8"). if nothing is found send 0',
+      'get the version from the blade cursor rules file. The file should be named `frontend-blade-rules.mdc` in `.cursor/rules/` directory. Extract the version from the `rules_version:` field at the start of the file (e.g., "0.0.8"). If the file does not exist, send 0',
     ),
 };
 
 const getBladePatternDocsToolCallback: ToolCallback<typeof getBladePatternDocsToolSchema> = ({
   patternsList,
   currentProjectRootDirectory,
   clientName,
-  cursorRuleFileName,
+  cursorRuleVersion,
 }) => {
   const components = patternsList.split(',').map((s) => s.trim());
   const invalidComponents = components.filter((comp) => !bladePatternsList.includes(comp));
@@ -64,18 +64,17 @@ const getBladePatternDocsToolCallback: ToolCallback<typeof getBladePatternDocsTo
     });
   }
 
-  if (cursorRuleFileName === '0' && clientName === 'cursor') {
+  if (cursorRuleVersion === '0' && clientName === 'cursor') {
     return handleError({
       toolName: getBladePatternDocsToolName,
       mcpErrorMessage: `Cursor rules do not exist. Call \`${createBladeCursorRulesToolName}\` first.`,
     });
   }
 
-  const expectedFileName = getCursorRulesFileName().replace('.mdc', '');
-  if (cursorRuleFileName !== expectedFileName && clientName === 'cursor') {
+  if (cursorRuleVersion !== CURSOR_RULES_VERSION && clientName === 'cursor') {
     return handleError({
       toolName: getBladePatternDocsToolName,
-      mcpErrorMessage: `Cursor rules are outdated. Expected file name: ${expectedFileName}.mdc. Call \`${createBladeCursorRulesToolName}\` first to update cursor rules`,
+      mcpErrorMessage: `Cursor rules are outdated. Expected version: ${CURSOR_RULES_VERSION}. Current version: ${cursorRuleVersion}. Call \`${createBladeCursorRulesToolName}\` first to update cursor rules`,
     });
   }
 
diff --git a/packages/blade-mcp/src/utils/tokens.ts b/packages/blade-mcp/src/utils/tokens.ts
@@ -17,9 +17,9 @@ const BLADE_CURSOR_RULES_FILE_PATH = join(
   'frontend-blade-rules.mdc',
 );
 
-// Generate cursor rules file name with version
+// Generate cursor rules file name (fixed name, version is in file content)
 const getCursorRulesFileName = (): string => {
-  return `frontend-blade-rules-v${CURSOR_RULES_VERSION}.mdc`;
+  return `frontend-blade-rules.mdc`;
 };
 
 const CONSUMER_CURSOR_RULES_RELATIVE_PATH = `.cursor/rules/${getCursorRulesFileName()}`;
