ai-readme-mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +496 -0
  3. package/dist/index.d.ts +2 -0
  4. package/dist/index.js +1073 -0
  5. package/dist/index.js.map +1 -0
  6. package/package.json +63 -0
package/dist/index.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts","../src/tools/discover.ts","../src/core/scanner.ts","../src/tools/getContext.ts","../src/core/router.ts","../src/tools/update.ts","../src/core/updater.ts","../src/core/validator.ts","../src/types/index.ts","../src/tools/validate.ts","../src/tools/init.ts"],"sourcesContent":["/**\n * AI_README MCP Server\n * Entry point for the MCP server\n */\n\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n CallToolRequestSchema,\n ListToolsRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { zodToJsonSchema } from 'zod-to-json-schema';\nimport {\n discoverAIReadmes,\n discoverSchema,\n type DiscoverInput,\n} from './tools/discover.js';\nimport {\n getContextForFile,\n getContextSchema,\n type GetContextInput,\n} from './tools/getContext.js';\nimport {\n updateAIReadme,\n updateSchema,\n type UpdateInput,\n} from './tools/update.js';\nimport {\n validateAIReadmes,\n validateSchema,\n type ValidateInput,\n} from './tools/validate.js';\nimport {\n initAIReadme,\n initSchema,\n type InitInput,\n} from './tools/init.js';\n\nconst server = new Server(\n {\n name: 'ai-readme-mcp',\n version: '0.1.0',\n },\n {\n capabilities: {\n tools: {},\n },\n }\n);\n\n// Register tool: list_tools\nserver.setRequestHandler(ListToolsRequestSchema, async () => {\n return {\n tools: [\n {\n name: 'discover_ai_readmes',\n description:\n 'Scan the project and discover all AI_README.md files. Returns an index of all README files with their paths, scopes, and coverage patterns.',\n inputSchema: zodToJsonSchema(discoverSchema),\n },\n {\n name: 'get_context_for_file',\n description:\n 'Get relevant AI_README context for a specific file path. Returns formatted context from relevant README files to help understand project conventions.',\n inputSchema: zodToJsonSchema(getContextSchema),\n },\n {\n name: 'update_ai_readme',\n description:\n 'Update an AI_README.md file with specified operations (append, prepend, replace, insert-after, insert-before). Auto-validates after update. Changes are written directly; use Git for version control.',\n inputSchema: zodToJsonSchema(updateSchema),\n },\n {\n name: 'validate_ai_readmes',\n description:\n 'Validate all AI_README.md files in a project. Checks token count, structure, and content quality. Returns validation results with suggestions for improvement.',\n inputSchema: zodToJsonSchema(validateSchema),\n },\n {\n name: 'init_ai_readme',\n description:\n 'Initialize a new AI_README.md file from a template. Creates a basic structure with common sections to help you get started quickly.',\n inputSchema: zodToJsonSchema(initSchema),\n },\n ],\n };\n});\n\n// Register tool: call_tool\nserver.setRequestHandler(CallToolRequestSchema, async (request) => {\n const { name, arguments: args } = request.params;\n\n try {\n if (name === 'discover_ai_readmes') {\n const input = discoverSchema.parse(args) as DiscoverInput;\n const result = await discoverAIReadmes(input);\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n\n if (name === 'get_context_for_file') {\n const input = getContextSchema.parse(args) as GetContextInput;\n const result = await getContextForFile(input);\n return {\n content: [\n {\n type: 'text',\n text: result.formattedPrompt,\n },\n ],\n };\n }\n\n if (name === 'update_ai_readme') {\n const input = updateSchema.parse(args) as UpdateInput;\n const result = await updateAIReadme(input);\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n\n if (name === 'validate_ai_readmes') {\n const input = validateSchema.parse(args) as ValidateInput;\n const result = await validateAIReadmes(input);\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n\n if (name === 'init_ai_readme') {\n const input = initSchema.parse(args) as InitInput;\n const result = await initAIReadme(input);\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n\n throw new Error(`Unknown tool: ${name}`);\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n return {\n content: [\n {\n type: 'text',\n text: `Error: ${errorMessage}`,\n },\n ],\n isError: true,\n };\n }\n});\n\nasync function main() {\n const transport = new StdioServerTransport();\n await server.connect(transport);\n\n console.error('AI_README MCP Server started');\n console.error('Available tools: discover_ai_readmes, get_context_for_file, update_ai_readme, validate_ai_readmes, init_ai_readme');\n}\n\nmain().catch((error) => {\n console.error('Fatal error:', error);\n process.exit(1);\n});\n","/**\n * MCP Tool: discover_ai_readmes\n * Scans the project and discovers all AI_README.md files\n */\n\nimport { z } from 'zod';\nimport { AIReadmeScanner } from '../core/scanner.js';\n\nexport const discoverSchema = z.object({\n projectRoot: z.string().describe('The root directory of the project'),\n excludePatterns: z\n .array(z.string())\n .optional()\n .describe(\"Glob patterns to exclude (e.g., ['node_modules/**', '.git/**'])\"),\n});\n\nexport type DiscoverInput = z.infer<typeof discoverSchema>;\n\nexport async function discoverAIReadmes(input: DiscoverInput) {\n const { projectRoot, excludePatterns } = input;\n\n // Create scanner with options\n const scanner = new AIReadmeScanner(projectRoot, {\n excludePatterns,\n cacheContent: false, // Don't cache content in discovery phase\n });\n\n // Scan the project\n const index = await scanner.scan();\n\n // Format the response\n return {\n projectRoot: index.projectRoot,\n totalFound: index.readmes.length,\n readmeFiles: index.readmes.map((readme) => ({\n path: readme.path,\n scope: readme.scope,\n level: readme.level,\n patterns: readme.patterns,\n })),\n lastUpdated: index.lastUpdated.toISOString(),\n };\n}\n","/**\n * AIReadmeScanner - Scans project directories for AI_README.md files\n */\n\nimport { glob } from 'glob';\nimport { readFile } from 'fs/promises';\nimport { dirname, join } from 'path';\nimport type { ReadmeEntry, ReadmeIndex, ScannerOptions } from '../types/index.js';\n\nexport class AIReadmeScanner {\n private projectRoot: string;\n private options: Required<ScannerOptions>;\n\n constructor(projectRoot: string, options?: ScannerOptions) {\n this.projectRoot = projectRoot;\n this.options = {\n excludePatterns: options?.excludePatterns || [\n '**/node_modules/**',\n '**/.git/**',\n '**/dist/**',\n '**/build/**',\n '**/.next/**',\n '**/coverage/**',\n ],\n cacheContent: options?.cacheContent ?? true,\n readmeFilename: options?.readmeFilename || 'AI_README.md',\n };\n }\n\n /**\n * Scan the project directory for AI_README.md files\n */\n async scan(): Promise<ReadmeIndex> {\n const pattern = `**/${this.options.readmeFilename}`;\n const ignore = this.options.excludePatterns;\n\n // Find all AI_README.md files\n const files = await glob(pattern, {\n cwd: this.projectRoot,\n ignore,\n absolute: false,\n nodir: true,\n });\n\n // Build ReadmeEntry objects\n const readmes: ReadmeEntry[] = [];\n\n for (const file of files) {\n const entry = await this.createReadmeEntry(file);\n readmes.push(entry);\n }\n\n // Sort by level (root first, then deeper levels)\n readmes.sort((a, b) => a.level - b.level);\n\n return {\n projectRoot: this.projectRoot,\n readmes,\n lastUpdated: new Date(),\n };\n }\n\n /**\n * Create a ReadmeEntry from a file path\n */\n private async createReadmeEntry(filePath: string): Promise<ReadmeEntry> {\n // Normalize path to use forward slashes (Unix-style) for consistency\n const normalizedPath = filePath.replace(/\\\\/g, '/');\n const dir = dirname(normalizedPath);\n const level = dir === '.' ? 0 : dir.split('/').length;\n const scope = dir === '.' ? 'root' : dir.replace(/\\//g, '-');\n\n // Generate glob patterns this README covers\n const patterns = this.generatePatterns(dir);\n\n // Optionally cache content\n let content: string | undefined;\n if (this.options.cacheContent) {\n try {\n const fullPath = join(this.projectRoot, filePath);\n content = await readFile(fullPath, 'utf-8');\n } catch (error) {\n console.error(`Failed to read ${filePath}:`, error);\n }\n }\n\n return {\n path: normalizedPath,\n scope,\n level,\n patterns,\n content,\n };\n }\n\n /**\n * Generate glob patterns that this README covers\n */\n private generatePatterns(dir: string): string[] {\n if (dir === '.') {\n return ['**/*']; // Root level covers everything\n }\n\n return [\n `${dir}/**/*`, // All files in this directory and subdirectories\n `${dir}/*`, // Direct children\n ];\n }\n\n /**\n * Refresh the scan (re-scan the project)\n */\n async refresh(): Promise<ReadmeIndex> {\n return this.scan();\n }\n\n /**\n * Get the project root directory\n */\n getProjectRoot(): string {\n return this.projectRoot;\n }\n\n /**\n * Get current scanner options\n */\n getOptions(): Required<ScannerOptions> {\n return { ...this.options };\n }\n}\n","/**\n * MCP Tool: get_context_for_file\n * Gets relevant AI_README context for a specific file path\n */\n\nimport { z } from 'zod';\nimport { AIReadmeScanner } from '../core/scanner.js';\nimport { ContextRouter } from '../core/router.js';\n\nexport const getContextSchema = z.object({\n projectRoot: z.string().describe('The root directory of the project'),\n filePath: z\n .string()\n .describe('The file path to get context for (relative to project root)'),\n includeRoot: z\n .boolean()\n .optional()\n .default(true)\n .describe('Whether to include root-level AI_README (default: true)'),\n excludePatterns: z\n .array(z.string())\n .optional()\n .describe('Glob patterns to exclude when scanning'),\n});\n\nexport type GetContextInput = z.infer<typeof getContextSchema>;\n\nexport async function getContextForFile(input: GetContextInput) {\n const { projectRoot, filePath, includeRoot, excludePatterns } = input;\n\n // First, scan the project to build the index\n const scanner = new AIReadmeScanner(projectRoot, {\n excludePatterns,\n cacheContent: true, // Cache content for context retrieval\n });\n\n const index = await scanner.scan();\n\n // Create router and get context\n const router = new ContextRouter(index);\n const contexts = await router.getContextForFile(filePath, includeRoot);\n\n // Format the response with a helpful prompt template\n const formattedContexts = contexts.map((ctx) => ({\n path: ctx.path,\n relevance: ctx.relevance,\n distance: ctx.distance,\n content: ctx.content,\n }));\n\n // Generate a formatted prompt for the AI\n let promptText = `## 📚 Project Context for: ${filePath}\\n\\n`;\n\n for (const ctx of formattedContexts) {\n if (ctx.relevance === 'root') {\n promptText += `### Root Conventions (${ctx.path})\\n\\n`;\n } else if (ctx.relevance === 'direct') {\n promptText += `### Direct Module Conventions (${ctx.path})\\n\\n`;\n } else {\n promptText += `### Parent Module Conventions (${ctx.path})\\n\\n`;\n }\n\n promptText += ctx.content + '\\n\\n';\n }\n\n promptText += `---\\n**Important Reminders:**\\n`;\n promptText += `- Follow the above conventions when making changes\\n`;\n promptText += `- If your changes affect architecture or conventions, consider updating the relevant AI_README\\n`;\n\n return {\n filePath,\n totalContexts: contexts.length,\n contexts: formattedContexts,\n formattedPrompt: promptText,\n };\n}\n","/**\n * ContextRouter - Routes file paths to relevant AI_README contexts\n */\n\nimport { minimatch } from 'minimatch';\nimport { dirname, join } from 'path';\nimport { readFile } from 'fs/promises';\nimport type { ReadmeContext, ReadmeIndex, ReadmeEntry } from '../types/index.js';\n\nexport class ContextRouter {\n private index: ReadmeIndex;\n\n constructor(index: ReadmeIndex) {\n this.index = index;\n }\n\n /**\n * Get relevant AI_README contexts for a specific file path\n * @param filePath - The file path relative to project root\n * @param includeRoot - Whether to include root-level README (default: true)\n */\n async getContextForFile(\n filePath: string,\n includeRoot: boolean = true\n ): Promise<ReadmeContext[]> {\n const contexts: ReadmeContext[] = [];\n\n // Find matching READMEs\n for (const readme of this.index.readmes) {\n const match = this.matchesPath(filePath, readme);\n\n if (!match) continue;\n\n // Skip root if not requested\n if (!includeRoot && readme.level === 0) continue;\n\n // Calculate distance from file to README\n const distance = this.calculateDistance(filePath, readme);\n\n // Get content\n const content = await this.getReadmeContent(readme);\n\n // Determine relevance\n const relevance = this.determineRelevance(filePath, readme);\n\n contexts.push({\n path: readme.path,\n content,\n relevance,\n distance,\n });\n }\n\n // Sort by distance (closest first) and then by relevance\n contexts.sort((a, b) => {\n if (a.distance !== b.distance) {\n return a.distance - b.distance;\n }\n // If same distance, prioritize direct > parent > root\n const relevanceOrder = { direct: 0, parent: 1, root: 2 };\n return relevanceOrder[a.relevance] - relevanceOrder[b.relevance];\n });\n\n return contexts;\n }\n\n /**\n * Get contexts for multiple files\n */\n async getContextForFiles(filePaths: string[]): Promise<Map<string, ReadmeContext[]>> {\n const results = new Map<string, ReadmeContext[]>();\n\n for (const filePath of filePaths) {\n const contexts = await this.getContextForFile(filePath);\n results.set(filePath, contexts);\n }\n\n return results;\n }\n\n /**\n * Check if a file path matches a README's patterns\n */\n private matchesPath(filePath: string, readme: ReadmeEntry): boolean {\n return readme.patterns.some(pattern => {\n return minimatch(filePath, pattern, { dot: true });\n });\n }\n\n /**\n * Calculate the directory distance between a file and a README\n */\n private calculateDistance(filePath: string, readme: ReadmeEntry): number {\n const fileDir = dirname(filePath);\n const readmeDir = dirname(readme.path);\n\n // If README is at root\n if (readmeDir === '.') {\n return fileDir === '.' ? 0 : fileDir.split('/').length;\n }\n\n // If file is in the same directory as README\n if (fileDir === readmeDir) {\n return 0;\n }\n\n // If file is in a subdirectory of README's directory\n if (fileDir.startsWith(readmeDir + '/')) {\n const subPath = fileDir.slice(readmeDir.length + 1);\n return subPath.split('/').length;\n }\n\n // Calculate levels up\n const fileParts = fileDir.split('/');\n const readmeParts = readmeDir.split('/');\n\n // Find common ancestor\n let commonDepth = 0;\n for (let i = 0; i < Math.min(fileParts.length, readmeParts.length); i++) {\n if (fileParts[i] === readmeParts[i]) {\n commonDepth++;\n } else {\n break;\n }\n }\n\n // Distance is the sum of levels to go up and down\n return (fileParts.length - commonDepth) + (readmeParts.length - commonDepth);\n }\n\n /**\n * Determine the relevance type of a README for a file\n */\n private determineRelevance(\n filePath: string,\n readme: ReadmeEntry\n ): 'root' | 'direct' | 'parent' {\n const fileDir = dirname(filePath);\n const readmeDir = dirname(readme.path);\n\n // Root level README\n if (readmeDir === '.') {\n return 'root';\n }\n\n // Direct match (same directory)\n if (fileDir === readmeDir) {\n return 'direct';\n }\n\n // Parent directory\n if (fileDir.startsWith(readmeDir + '/')) {\n return 'parent';\n }\n\n return 'parent';\n }\n\n /**\n * Get the content of a README (from cache or file system)\n */\n private async getReadmeContent(readme: ReadmeEntry): Promise<string> {\n // Return cached content if available\n if (readme.content) {\n return readme.content;\n }\n\n // Otherwise read from file system\n try {\n const fullPath = join(this.index.projectRoot, readme.path);\n return await readFile(fullPath, 'utf-8');\n } catch (error) {\n console.error(`Failed to read ${readme.path}:`, error);\n return `[Error: Could not read ${readme.path}]`;\n }\n }\n\n /**\n * Update the index (useful after re-scanning)\n */\n updateIndex(index: ReadmeIndex): void {\n this.index = index;\n }\n\n /**\n * Get the current index\n */\n getIndex(): ReadmeIndex {\n return this.index;\n }\n}\n","import { z } from 'zod';\nimport { dirname } from 'path';\nimport { ReadmeUpdater, UpdateOperation } from '../core/updater.js';\nimport { ReadmeValidator } from '../core/validator.js';\n\n/**\n * Zod schema for update operation\n */\nconst updateOperationSchema = z.object({\n type: z.enum(['replace', 'append', 'prepend', 'insert-after', 'insert-before']).describe(\n 'Type of update operation'\n ),\n section: z.string().optional().describe(\n 'Section heading to target (e.g., \"## Coding Conventions\")'\n ),\n searchText: z.string().optional().describe(\n 'Text to search for (required for replace operation)'\n ),\n content: z.string().describe('Content to add or replace'),\n});\n\n/**\n * Zod schema for update_ai_readme tool\n */\nexport const updateSchema = z.object({\n readmePath: z.string().describe('Path to the AI_README.md file to update'),\n operations: z.array(updateOperationSchema).describe(\n 'List of update operations to perform'\n ),\n});\n\nexport type UpdateInput = z.infer<typeof updateSchema>;\n\n/**\n * Update an AI_README.md file with specified operations\n *\n * @param input - Update parameters\n * @returns Update result with changes\n *\n * @example\n * ```typescript\n * await updateAIReadme({\n * readmePath: 'apps/frontend/AI_README.md',\n * operations: [{\n * type: 'insert-after',\n * section: '## Directory Structure',\n * content: '├── src/hooks/ # Custom React hooks'\n * }]\n * });\n * ```\n *\n * Note: Changes are immediately written to the file.\n * Use git to track changes and rollback if needed.\n */\nexport async function updateAIReadme(input: UpdateInput) {\n const { readmePath, operations } = input;\n\n const updater = new ReadmeUpdater();\n\n // Perform update\n const result = await updater.update(readmePath, operations as UpdateOperation[]);\n\n if (!result.success) {\n return {\n success: false,\n readmePath,\n error: result.error,\n summary: `Failed to update ${readmePath}: ${result.error}`,\n };\n }\n\n // Auto-validate after update\n try {\n const projectRoot = dirname(dirname(readmePath)); // Approximate project root\n const config = await ReadmeValidator.loadConfig(projectRoot);\n const validator = new ReadmeValidator(config || undefined);\n const validation = await validator.validate(readmePath);\n\n // Collect validation warnings\n const warnings = validation.issues\n .filter(i => i.type === 'warning' || i.type === 'error')\n .map(i => `[${i.type.toUpperCase()}] ${i.message}`);\n\n return {\n success: true,\n readmePath,\n changes: result.changes,\n summary: `Successfully updated ${readmePath} with ${result.changes.length} operation(s). Use 'git diff' to review changes.`,\n validation: {\n valid: validation.valid,\n score: validation.score,\n warnings: warnings.length > 0 ? warnings : undefined,\n stats: validation.stats,\n },\n };\n } catch (validationError) {\n // If validation fails, still return success for the update\n return {\n success: true,\n readmePath,\n changes: result.changes,\n summary: `Successfully updated ${readmePath} with ${result.changes.length} operation(s). Use 'git diff' to review changes.`,\n validation: {\n valid: false,\n error: validationError instanceof Error ? validationError.message : 'Validation failed',\n },\n };\n }\n}\n","import { readFile, writeFile } from 'fs/promises';\nimport { existsSync } from 'fs';\n\nexport interface UpdateOperation {\n type: 'replace' | 'append' | 'prepend' | 'insert-after' | 'insert-before';\n section?: string; // Section heading to target (e.g., \"## Coding Conventions\")\n searchText?: string; // Text to search for (for replace operations)\n content: string; // Content to add/replace\n}\n\nexport interface UpdateResult {\n success: boolean;\n changes: {\n operation: string;\n section?: string;\n linesAdded: number;\n linesRemoved: number;\n }[];\n error?: string;\n}\n\n/**\n * ReadmeUpdater - Handles updating AI_README.md files\n *\n * Features:\n * - Section-based updates\n * - Multiple operation types (append, prepend, replace, insert-after, insert-before)\n * - Detailed change tracking\n *\n * Note: Version control is handled by Git. Use git diff/revert for rollback.\n */\nexport class ReadmeUpdater {\n constructor() {\n // No configuration needed\n }\n\n /**\n * Update a README file with given operations\n *\n * @param readmePath - Path to the AI_README.md file\n * @param operations - List of update operations\n * @returns Update result with changes\n */\n async update(\n readmePath: string,\n operations: UpdateOperation[]\n ): Promise<UpdateResult> {\n try {\n // Check if file exists\n if (!existsSync(readmePath)) {\n return {\n success: false,\n error: `File not found: ${readmePath}`,\n changes: [],\n };\n }\n\n // Read current content\n const content = await readFile(readmePath, 'utf-8');\n\n // Apply operations\n let updatedContent = content;\n const changes: UpdateResult['changes'] = [];\n\n for (const operation of operations) {\n const result = await this.applyOperation(updatedContent, operation);\n updatedContent = result.content;\n changes.push(result.change);\n }\n\n // Write updated content\n await writeFile(readmePath, updatedContent, 'utf-8');\n\n return {\n success: true,\n changes,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : String(error),\n changes: [],\n };\n }\n }\n\n /**\n * Apply a single update operation to content\n *\n * @param content - Current content\n * @param operation - Operation to apply\n * @returns Updated content and change info\n */\n private async applyOperation(\n content: string,\n operation: UpdateOperation\n ): Promise<{ content: string; change: UpdateResult['changes'][0] }> {\n const lines = content.split('\\n');\n let updatedLines = [...lines];\n let linesAdded = 0;\n let linesRemoved = 0;\n\n switch (operation.type) {\n case 'append': {\n // Add content to the end\n updatedLines.push('', operation.content);\n linesAdded = operation.content.split('\\n').length + 1;\n break;\n }\n\n case 'prepend': {\n // Add content to the beginning\n updatedLines.unshift(operation.content, '');\n linesAdded = operation.content.split('\\n').length + 1;\n break;\n }\n\n case 'replace': {\n // Replace specific text\n if (!operation.searchText) {\n throw new Error('searchText is required for replace operation');\n }\n\n const originalContent = updatedLines.join('\\n');\n const newContent = originalContent.replace(\n operation.searchText,\n operation.content\n );\n\n if (originalContent === newContent) {\n throw new Error(`Text not found: ${operation.searchText}`);\n }\n\n updatedLines = newContent.split('\\n');\n linesRemoved = operation.searchText.split('\\n').length;\n linesAdded = operation.content.split('\\n').length;\n break;\n }\n\n case 'insert-after': {\n // Insert content after a section\n if (!operation.section) {\n throw new Error('section is required for insert-after operation');\n }\n\n const sectionIndex = this.findSectionIndex(updatedLines, operation.section);\n if (sectionIndex === -1) {\n throw new Error(`Section not found: ${operation.section}`);\n }\n\n // Find the end of the section content\n const insertIndex = this.findSectionEnd(updatedLines, sectionIndex);\n updatedLines.splice(insertIndex, 0, '', operation.content);\n linesAdded = operation.content.split('\\n').length + 1;\n break;\n }\n\n case 'insert-before': {\n // Insert content before a section\n if (!operation.section) {\n throw new Error('section is required for insert-before operation');\n }\n\n const sectionIndex = this.findSectionIndex(updatedLines, operation.section);\n if (sectionIndex === -1) {\n throw new Error(`Section not found: ${operation.section}`);\n }\n\n updatedLines.splice(sectionIndex, 0, operation.content, '');\n linesAdded = operation.content.split('\\n').length + 1;\n break;\n }\n\n default:\n throw new Error(`Unknown operation type: ${operation.type}`);\n }\n\n return {\n content: updatedLines.join('\\n'),\n change: {\n operation: operation.type,\n section: operation.section,\n linesAdded,\n linesRemoved,\n },\n };\n }\n\n /**\n * Find the index of a section heading\n *\n * @param lines - Content lines\n * @param section - Section heading (e.g., \"## Coding Conventions\")\n * @returns Index of the section, or -1 if not found\n */\n private findSectionIndex(lines: string[], section: string): number {\n return lines.findIndex((line) => line.trim() === section.trim());\n }\n\n /**\n * Find the end of a section (before the next section of same or higher level)\n *\n * @param lines - Content lines\n * @param startIndex - Index of the section heading\n * @returns Index where the section ends\n */\n private findSectionEnd(lines: string[], startIndex: number): number {\n const startLine = lines[startIndex];\n if (!startLine) {\n return lines.length;\n }\n\n const sectionLevel = this.getSectionLevel(startLine);\n\n for (let i = startIndex + 1; i < lines.length; i++) {\n const line = lines[i];\n if (!line) continue;\n\n const trimmedLine = line.trim();\n if (trimmedLine.startsWith('#')) {\n const level = this.getSectionLevel(trimmedLine);\n if (level <= sectionLevel) {\n return i;\n }\n }\n }\n\n return lines.length;\n }\n\n /**\n * Get the heading level of a markdown section\n *\n * @param line - Line containing a heading\n * @returns Heading level (1-6)\n */\n private getSectionLevel(line: string): number {\n const match = line.match(/^(#{1,6})\\s/);\n return match && match[1] ? match[1].length : 0;\n }\n}\n","import { readFile } from 'fs/promises';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport type {\n ValidationConfig,\n ResolvedValidationConfig,\n ValidationResult,\n ValidationIssue,\n} from '../types/index.js';\nimport { DEFAULT_VALIDATION_CONFIG } from '../types/index.js';\n\n/**\n * ReadmeValidator - Validates AI_README.md files\n *\n * Features:\n * - Token count validation\n * - Structure validation\n * - Content quality checks\n * - Configurable rules via constructor parameter\n */\nexport class ReadmeValidator {\n private config: ResolvedValidationConfig;\n\n constructor(config?: Partial<ValidationConfig>) {\n // Merge user config with defaults\n this.config = this.mergeConfig(config || {});\n }\n\n /**\n * Merge user config with default config\n */\n private mergeConfig(userConfig: Partial<ValidationConfig>): ResolvedValidationConfig {\n return {\n maxTokens: userConfig.maxTokens ?? DEFAULT_VALIDATION_CONFIG.maxTokens,\n rules: {\n ...DEFAULT_VALIDATION_CONFIG.rules,\n ...(userConfig.rules || {}),\n },\n tokenLimits: {\n ...DEFAULT_VALIDATION_CONFIG.tokenLimits,\n ...(userConfig.tokenLimits || {}),\n },\n };\n }\n\n /**\n * Validate a single AI_README.md file\n *\n * @param readmePath - Path to the README file\n * @returns Validation result\n */\n async validate(readmePath: string): Promise<ValidationResult> {\n const issues: ValidationIssue[] = [];\n\n // Check file exists\n if (!existsSync(readmePath)) {\n return {\n valid: false,\n filePath: readmePath,\n issues: [\n {\n type: 'error',\n rule: 'structure',\n message: `File not found: ${readmePath}`,\n },\n ],\n };\n }\n\n // Read content\n const content = await readFile(readmePath, 'utf-8');\n\n // Check if file is empty\n if (content.trim().length === 0) {\n issues.push({\n type: 'error',\n rule: 'empty-content',\n message: 'README file is empty',\n suggestion: 'Add content to the README file',\n });\n }\n\n // Calculate statistics\n const lines = content.split('\\n');\n const tokens = this.estimateTokens(content);\n const characters = content.length;\n\n // Validate token count\n this.validateTokenCount(tokens, issues);\n\n // Validate structure\n this.validateStructure(content, lines, issues);\n\n // Validate line length\n this.validateLineLength(lines, issues);\n\n // Validate code blocks\n this.validateCodeBlocks(content, issues);\n\n // Calculate score\n const score = this.calculateScore(issues, tokens);\n\n return {\n valid: !issues.some((i) => i.type === 'error'),\n filePath: readmePath,\n issues,\n score,\n stats: {\n tokens,\n lines: lines.length,\n characters,\n },\n };\n }\n\n /**\n * Estimate token count (simple word-based estimation)\n * Formula: words * 1.3 (approximate token-to-word ratio)\n */\n private estimateTokens(content: string): number {\n const words = content.split(/\\s+/).filter((w) => w.length > 0).length;\n return Math.round(words * 1.3);\n }\n\n /**\n * Validate token count against limits\n */\n private validateTokenCount(tokens: number, issues: ValidationIssue[]): void {\n const { tokenLimits, maxTokens } = this.config;\n\n if (tokens > tokenLimits.error) {\n issues.push({\n type: 'error',\n rule: 'token-count',\n message: `README is too long (${tokens} tokens). Maximum recommended: ${maxTokens} tokens.`,\n suggestion: 'Remove unnecessary content, use bullet points instead of paragraphs, and avoid code examples.',\n });\n } else if (tokens > tokenLimits.warning) {\n issues.push({\n type: 'warning',\n rule: 'token-count',\n message: `README is quite long (${tokens} tokens). Consider keeping it under ${tokenLimits.good} tokens.`,\n suggestion: 'Simplify content and remove redundant information.',\n });\n } else if (tokens > tokenLimits.good) {\n issues.push({\n type: 'info',\n rule: 'token-count',\n message: `README length is acceptable (${tokens} tokens).`,\n });\n }\n }\n\n /**\n * Validate README structure\n */\n private validateStructure(_content: string, lines: string[], issues: ValidationIssue[]): void {\n // Check for H1 heading\n if (this.config.rules.requireH1) {\n const hasH1 = lines.some((line) => line.trim().match(/^#\\s+[^#]/));\n if (!hasH1) {\n issues.push({\n type: 'error',\n rule: 'require-h1',\n message: 'README must have a H1 heading (# Title)',\n suggestion: 'Add a title at the beginning of the file: # Project Name',\n });\n }\n }\n\n // Check for required sections\n if (this.config.rules.requireSections && this.config.rules.requireSections.length > 0) {\n for (const section of this.config.rules.requireSections) {\n const hasSection = lines.some((line) => line.trim() === section);\n if (!hasSection) {\n issues.push({\n type: 'warning',\n rule: 'require-sections',\n message: `Missing required section: ${section}`,\n suggestion: `Add section: ${section}`,\n });\n }\n }\n }\n }\n\n /**\n * Validate line length\n */\n private validateLineLength(lines: string[], issues: ValidationIssue[]): void {\n const { maxLineLength } = this.config.rules;\n const longLines = lines\n .map((line, index) => ({ line, index }))\n .filter(({ line }) => line.length > maxLineLength);\n\n if (longLines.length > 3) {\n // Only warn if there are many long lines\n issues.push({\n type: 'info',\n rule: 'line-length',\n message: `${longLines.length} lines exceed ${maxLineLength} characters`,\n suggestion: 'Consider breaking long lines for better readability',\n });\n }\n }\n\n /**\n * Validate code blocks\n */\n private validateCodeBlocks(content: string, issues: ValidationIssue[]): void {\n if (!this.config.rules.allowCodeBlocks) {\n const codeBlockCount = (content.match(/```/g) || []).length / 2;\n if (codeBlockCount > 0) {\n issues.push({\n type: 'warning',\n rule: 'code-blocks',\n message: `Found ${codeBlockCount} code blocks. Code examples consume many tokens.`,\n suggestion: 'Remove code examples or move them to separate documentation.',\n });\n }\n }\n }\n\n /**\n * Calculate quality score (0-100)\n */\n private calculateScore(issues: ValidationIssue[], tokens: number): number {\n let score = 100;\n\n // Deduct points for issues\n for (const issue of issues) {\n if (issue.type === 'error') score -= 20;\n else if (issue.type === 'warning') score -= 10;\n else if (issue.type === 'info') score -= 2;\n }\n\n // Deduct points for excessive length\n const { tokenLimits } = this.config;\n if (tokens > tokenLimits.error) score -= 30;\n else if (tokens > tokenLimits.warning) score -= 15;\n else if (tokens < tokenLimits.excellent) score += 10; // Bonus for concise READMEs\n\n return Math.max(0, Math.min(100, score));\n }\n\n /**\n * Load validation config from .aireadme.config.json\n *\n * @param projectRoot - Project root directory\n * @returns Validation config or null if not found\n */\n static async loadConfig(projectRoot: string): Promise<Partial<ValidationConfig> | null> {\n const configPath = join(projectRoot, '.aireadme.config.json');\n\n if (!existsSync(configPath)) {\n return null;\n }\n\n try {\n const content = await readFile(configPath, 'utf-8');\n const config = JSON.parse(content);\n return config.validation || config; // Support both formats\n } catch (error) {\n console.error(`Failed to load config from ${configPath}:`, error);\n return null;\n }\n }\n}\n","/**\n * Core type definitions for AI_README MCP Server\n */\n\n/**\n * Represents a single AI_README.md file entry in the index\n */\nexport interface ReadmeEntry {\n /** Absolute or relative path to the AI_README.md file */\n path: string;\n /** Scope identifier (e.g., 'root', 'frontend', 'backend') */\n scope: string;\n /** Directory level depth (0 for root) */\n level: number;\n /** Glob patterns this README covers */\n patterns: string[];\n /** Cached content of the README (optional) */\n content?: string;\n}\n\n/**\n * Index of all AI_README files in the project\n */\nexport interface ReadmeIndex {\n /** Root directory of the project */\n projectRoot: string;\n /** List of discovered README entries */\n readmes: ReadmeEntry[];\n /** Timestamp of last index update */\n lastUpdated: Date;\n}\n\n/**\n * Context information for a specific file\n */\nexport interface ReadmeContext {\n /** Path to the AI_README.md file */\n path: string;\n /** Content of the README */\n content: string;\n /** Relevance type */\n relevance: 'root' | 'direct' | 'parent';\n /** Distance in directory levels from target file */\n distance: number;\n}\n\n/**\n * Options for the scanner\n */\nexport interface ScannerOptions {\n /** Patterns to exclude from scanning */\n excludePatterns?: string[];\n /** Whether to cache README contents */\n cacheContent?: boolean;\n /** Custom README filename (default: 'AI_README.md') */\n readmeFilename?: string;\n}\n\n/**\n * Update action types for AI_README modifications\n */\nexport type UpdateAction = 'append' | 'replace' | 'delete';\n\n/**\n * Result of an update operation\n */\nexport interface UpdateResult {\n /** Whether the update succeeded */\n success: boolean;\n /** Path to the updated file */\n updatedPath: string;\n /** Path to backup file (if created) */\n backupPath?: string;\n /** Diff of changes made */\n diff: string;\n}\n\n/**\n * Options for the updater\n */\nexport interface UpdaterOptions {\n /** Directory for backups (default: '.ai_readme_history') */\n backupDir?: string;\n /** Whether to create backups */\n createBackup?: boolean;\n}\n\n/**\n * Validation configuration\n */\nexport interface ValidationConfig {\n /** Maximum tokens allowed (default: 500) */\n maxTokens?: number;\n /** Validation rules */\n rules?: {\n /** Require H1 heading (default: true) */\n requireH1?: boolean;\n /** Required sections (default: []) */\n requireSections?: string[];\n /** Allow code blocks (default: true) */\n allowCodeBlocks?: boolean;\n /** Maximum line length (default: 120) */\n maxLineLength?: number;\n };\n /** Token limit thresholds */\n tokenLimits?: {\n /** Excellent: under this many tokens (default: 300) */\n excellent?: number;\n /** Good: under this many tokens (default: 500) */\n good?: number;\n /** Warning: under this many tokens (default: 800) */\n warning?: number;\n /** Error: over this many tokens (default: 1200) */\n error?: number;\n };\n}\n\n/**\n * Fully resolved validation configuration (all properties required)\n */\nexport interface ResolvedValidationConfig {\n maxTokens: number;\n rules: {\n requireH1: boolean;\n requireSections: string[];\n allowCodeBlocks: boolean;\n maxLineLength: number;\n };\n tokenLimits: {\n excellent: number;\n good: number;\n warning: number;\n error: number;\n };\n}\n\n/**\n * Default validation configuration\n */\nexport const DEFAULT_VALIDATION_CONFIG: ResolvedValidationConfig = {\n maxTokens: 400,\n rules: {\n requireH1: true,\n requireSections: [],\n allowCodeBlocks: false,\n maxLineLength: 100,\n },\n tokenLimits: {\n excellent: 200,\n good: 400,\n warning: 600,\n error: 1000,\n },\n};\n\n/**\n * Validation issue severity\n */\nexport type ValidationSeverity = 'error' | 'warning' | 'info';\n\n/**\n * Validation rule type\n */\nexport type ValidationRule =\n | 'token-count'\n | 'require-h1'\n | 'require-sections'\n | 'code-blocks'\n | 'line-length'\n | 'empty-content'\n | 'structure';\n\n/**\n * Validation issue\n */\nexport interface ValidationIssue {\n /** Issue severity */\n type: ValidationSeverity;\n /** Rule that triggered this issue */\n rule: ValidationRule;\n /** Issue message */\n message: string;\n /** Line number (if applicable) */\n line?: number;\n /** Suggestion for fixing */\n suggestion?: string;\n}\n\n/**\n * Validation result for a single README\n */\nexport interface ValidationResult {\n /** Whether validation passed */\n valid: boolean;\n /** Path to the README file */\n filePath: string;\n /** List of issues found */\n issues: ValidationIssue[];\n /** Quality score (0-100) */\n score?: number;\n /** Token count statistics */\n stats?: {\n tokens: number;\n lines: number;\n characters: number;\n };\n}\n","import { z } from 'zod';\nimport { ReadmeValidator } from '../core/validator.js';\nimport { AIReadmeScanner } from '../core/scanner.js';\nimport type { ValidationConfig } from '../types/index.js';\n\n/**\n * Zod schema for validate_ai_readmes tool\n */\nexport const validateSchema = z.object({\n projectRoot: z.string().describe('The root directory of the project'),\n excludePatterns: z.array(z.string()).optional().describe(\n 'Glob patterns to exclude (e.g., [\"node_modules/**\", \".git/**\"])'\n ),\n config: z.object({\n maxTokens: z.number().optional(),\n rules: z.object({\n requireH1: z.boolean().optional(),\n requireSections: z.array(z.string()).optional(),\n allowCodeBlocks: z.boolean().optional(),\n maxLineLength: z.number().optional(),\n }).optional(),\n tokenLimits: z.object({\n excellent: z.number().optional(),\n good: z.number().optional(),\n warning: z.number().optional(),\n error: z.number().optional(),\n }).optional(),\n }).optional().describe('Custom validation configuration (optional, uses defaults if not provided)'),\n});\n\nexport type ValidateInput = z.infer<typeof validateSchema>;\n\n/**\n * Validate all AI_README.md files in a project\n *\n * @param input - Validation parameters\n * @returns Validation results for all README files\n *\n * @example\n * ```typescript\n * await validateAIReadmes({\n * projectRoot: '/path/to/project',\n * excludePatterns: ['node_modules/**'],\n * config: {\n * maxTokens: 500,\n * rules: {\n * requireH1: true,\n * requireSections: ['## Architecture', '## Conventions']\n * }\n * }\n * });\n * ```\n */\nexport async function validateAIReadmes(input: ValidateInput) {\n const { projectRoot, excludePatterns, config: userConfig } = input;\n\n try {\n // Use provided config, fallback to file config if available, then defaults\n let config: Partial<ValidationConfig> | undefined = userConfig;\n\n if (!config) {\n // Optionally load from .aireadme.config.json if it exists\n const fileConfig = await ReadmeValidator.loadConfig(projectRoot);\n if (fileConfig) {\n config = fileConfig;\n }\n }\n\n // Create validator with config\n const validator = new ReadmeValidator(config);\n\n // Scan for all README files\n const scanner = new AIReadmeScanner(projectRoot, {\n excludePatterns: excludePatterns || [],\n cacheContent: false,\n });\n const index = await scanner.scan();\n\n // Validate each README\n const results = [];\n for (const readme of index.readmes) {\n const result = await validator.validate(readme.path);\n results.push(result);\n }\n\n // Calculate overall statistics\n const totalFiles = results.length;\n const validFiles = results.filter(r => r.valid).length;\n const totalIssues = results.reduce((sum, r) => sum + r.issues.length, 0);\n const averageScore = totalFiles > 0\n ? Math.round(results.reduce((sum, r) => sum + (r.score || 0), 0) / totalFiles)\n : 0;\n\n // Group issues by severity\n const issuesBySeverity = {\n error: 0,\n warning: 0,\n info: 0,\n };\n for (const result of results) {\n for (const issue of result.issues) {\n issuesBySeverity[issue.type]++;\n }\n }\n\n return {\n success: true,\n projectRoot,\n summary: {\n totalFiles,\n validFiles,\n invalidFiles: totalFiles - validFiles,\n totalIssues,\n averageScore,\n issuesBySeverity,\n },\n results,\n message: totalIssues === 0\n ? `All ${totalFiles} README files passed validation! Average score: ${averageScore}/100`\n : `Found ${totalIssues} issues across ${totalFiles} README files. ${validFiles} files passed validation.`,\n };\n } catch (error) {\n return {\n success: false,\n projectRoot,\n error: error instanceof Error ? error.message : String(error),\n message: `Validation failed: ${error instanceof Error ? error.message : String(error)}`,\n };\n }\n}\n","import { z } from 'zod';\nimport { readFile, writeFile } from 'fs/promises';\nimport { join, dirname } from 'path';\nimport { existsSync } from 'fs';\nimport { fileURLToPath } from 'url';\n\n/**\n * Zod schema for init_ai_readme tool\n */\nexport const initSchema = z.object({\n targetPath: z.string().describe('Directory where AI_README.md will be created'),\n projectName: z.string().optional().describe('Project name to use in the template (optional)'),\n overwrite: z.boolean().optional().describe('Whether to overwrite existing AI_README.md (default: false)'),\n});\n\nexport type InitInput = z.infer<typeof initSchema>;\n\n/**\n * Initialize a new AI_README.md file from template\n *\n * @param input - Initialization parameters\n * @returns Result with created file path\n *\n * @example\n * ```typescript\n * await initAIReadme({\n * targetPath: '/path/to/project',\n * projectName: 'My Awesome Project',\n * overwrite: false\n * });\n * ```\n */\nexport async function initAIReadme(input: InitInput) {\n const { targetPath, projectName, overwrite = false } = input;\n\n try {\n // Validate target path\n if (!existsSync(targetPath)) {\n return {\n success: false,\n error: `Target directory does not exist: ${targetPath}`,\n message: `Failed to create AI_README.md: Directory not found`,\n };\n }\n\n const readmePath = join(targetPath, 'AI_README.md');\n\n // Check if file already exists\n if (existsSync(readmePath) && !overwrite) {\n return {\n success: false,\n error: 'AI_README.md already exists',\n message: `AI_README.md already exists at ${readmePath}. Use overwrite: true to replace it.`,\n existingPath: readmePath,\n };\n }\n\n // Get template path\n // In production (dist/), template is at ../../docs/templates/basic.md\n // In development (src/), template is at ../../docs/templates/basic.md\n const __filename = fileURLToPath(import.meta.url);\n const __dirname = dirname(__filename);\n const templatePath = join(__dirname, '..', '..', 'docs', 'templates', 'basic.md');\n\n if (!existsSync(templatePath)) {\n return {\n success: false,\n error: `Template file not found: ${templatePath}`,\n message: 'Template file is missing. Please check installation.',\n };\n }\n\n // Read template\n let content = await readFile(templatePath, 'utf-8');\n\n // Replace placeholders\n const finalProjectName = projectName || 'Project Name';\n content = content.replace(/\\{\\{PROJECT_NAME\\}\\}/g, finalProjectName);\n\n // Write to target\n await writeFile(readmePath, content, 'utf-8');\n\n return {\n success: true,\n readmePath,\n projectName: finalProjectName,\n message: `Successfully created AI_README.md at ${readmePath}. Edit the file to customize it for your project.`,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : String(error),\n message: `Failed to create AI_README.md: ${error instanceof Error ? error.message : String(error)}`,\n };\n }\n}\n"],"mappings":"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","names":["z","dirname","join","readFile","z","z","dirname","readFile","readFile","existsSync","join","existsSync","readFile","join","z","dirname","z","z","z","readFile","writeFile","join","dirname","existsSync","__filename","__dirname"]}
package/package.json ADDED
@@ -0,0 +1,63 @@
1
+ {
2
+ "name": "ai-readme-mcp",
3
+ "version": "0.1.0",
4
+ "description": "MCP server for managing AI_README.md files in projects",
5
+ "type": "module",
6
+ "bin": {
7
+ "ai-readme-mcp": "./dist/index.js"
8
+ },
9
+ "main": "./dist/index.js",
10
+ "types": "./dist/index.d.ts",
11
+ "files": [
12
+ "dist"
13
+ ],
14
+ "scripts": {
15
+ "dev": "tsup --watch",
16
+ "build": "tsup",
17
+ "test": "tsx --test tests/**/*.test.ts",
18
+ "test:watch": "tsx --test --watch tests/**/*.test.ts",
19
+ "typecheck": "tsc --noEmit",
20
+ "prepublishOnly": "npm run build"
21
+ },
22
+ "dependencies": {
23
+ "@modelcontextprotocol/sdk": "^0.5.0",
24
+ "fs-extra": "^11.2.0",
25
+ "glob": "^10.3.10",
26
+ "minimatch": "^9.0.3",
27
+ "remark": "^15.0.1",
28
+ "remark-parse": "^11.0.0",
29
+ "simple-git": "^3.22.0",
30
+ "unified": "^11.0.4",
31
+ "zod": "^3.22.4",
32
+ "zod-to-json-schema": "^3.24.6"
33
+ },
34
+ "devDependencies": {
35
+ "@types/fs-extra": "^11.0.4",
36
+ "@types/node": "^20.11.5",
37
+ "tsup": "^8.0.1",
38
+ "tsx": "^4.20.6",
39
+ "typescript": "^5.3.3"
40
+ },
41
+ "keywords": [
42
+ "mcp",
43
+ "ai",
44
+ "readme",
45
+ "context",
46
+ "claude",
47
+ "llm",
48
+ "model-context-protocol"
49
+ ],
50
+ "author": "Draco Cheng <draco.cheng@outlook.com>",
51
+ "license": "MIT",
52
+ "repository": {
53
+ "type": "git",
54
+ "url": "https://github.com/Draco-Cheng/ai-readme-mcp.git"
55
+ },
56
+ "bugs": {
57
+ "url": "https://github.com/Draco-Cheng/ai-readme-mcp/issues"
58
+ },
59
+ "homepage": "https://github.com/Draco-Cheng/ai-readme-mcp#readme",
60
+ "engines": {
61
+ "node": ">=18.0.0"
62
+ }
63
+ }