parse_file_metadata
Extract AI metadata from files to enable persistent memory and project awareness for coding assistants.
Instructions
Parse AI metadata from a file
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filePath | Yes | Path to the file |
Implementation Reference
- src/index.ts:652-662 (registration)Registration of the 'parse_file_metadata' tool in the MCP server, including name, description, and input schema requiring 'filePath'.
{ name: 'parse_file_metadata', description: 'Parse AI metadata from a file', inputSchema: { type: 'object', properties: { filePath: { type: 'string', description: 'Path to the file' } }, required: ['filePath'] } }, - src/index.ts:848-852 (handler)Tool handler in the switch statement that processes 'parse_file_metadata' calls: extracts filePath, invokes MetadataParser.parseFileMetadata, and returns JSON-formatted result.
case 'parse_file_metadata': { const filePath = args.filePath as string; const parsedMetadata = await this.metadataParser.parseFileMetadata(filePath); return { content: [{ type: 'text', text: JSON.stringify(parsedMetadata, null, 2) }] }; } - src/metadata-parser.ts:47-55 (handler)Core implementation of file metadata parsing: reads file content and delegates to extractMetadataFromContent, with error handling.
async parseFileMetadata(filePath: string): Promise<AIMetadata | null> { try { const content = await fs.readFile(filePath, 'utf-8'); return this.extractMetadataFromContent(content); } catch (error) { console.error(chalk.red(`Error reading file ${filePath}:`), error); return null; } } - src/metadata-parser.ts:57-92 (helper)Helper function that extracts and parses the @ai-metadata block from file content using regex and field-specific parsers.
extractMetadataFromContent(content: string): AIMetadata | null { // Look for @ai-metadata block const metadataRegex = /\/\*\*[\s\S]*?@ai-metadata[\s\S]*?\*\//; const match = content.match(metadataRegex); if (!match) { return null; } const metadataBlock = match[0]; const metadata: AIMetadata = {}; // Parse each field this.parseField(metadataBlock, '@class:', (value) => metadata.class = value); this.parseField(metadataBlock, '@description:', (value) => metadata.description = value); this.parseField(metadataBlock, '@last-update:', (value) => metadata.lastUpdate = value); this.parseField(metadataBlock, '@last-editor:', (value) => metadata.lastEditor = value); this.parseField(metadataBlock, '@changelog:', (value) => metadata.changelog = value); this.parseField(metadataBlock, '@stability:', (value) => metadata.stability = value as any); this.parseField(metadataBlock, '@edit-permissions:', (value) => metadata.editPermissions = value as any); this.parseField(metadataBlock, '@breaking-changes-risk:', (value) => metadata.breakingChangesRisk = value as any); this.parseField(metadataBlock, '@review-required:', (value) => metadata.reviewRequired = value === 'true'); this.parseField(metadataBlock, '@ai-context:', (value) => metadata.aiContext = value); // Parse arrays this.parseArrayField(metadataBlock, '@dependencies:', (value) => metadata.dependencies = value); this.parseArrayField(metadataBlock, '@tests:', (value) => metadata.tests = value); // Parse method permissions (JSON object) this.parseJsonField(metadataBlock, '@method-permissions:', (value) => metadata.methodPermissions = value); // Parse approvals metadata.approvals = this.parseApprovals(metadataBlock); return metadata; }