Documentation Generator MCP Server

{ "changes_summary": { "title": "AI Contributor Naming System Implementation", "date": "2025-10-13", "purpose": "Implemented standardized AI contributor naming system for changelog entries", "status": "TO_BE_REVERTED", "files_modified": 5, "test_entries_created": 7 }, "files_modified": [ { "file": "constants.py", "changes": [ "Added AIContributorNames class (lines 177-273)", "Added standardized AI system names: Claude (Anthropic), ChatGPT (OpenAI), Gemini (Google), Cursor AI, GitHub Copilot, Codex (OpenAI)", "Added NAME_MAPPING dictionary with common variations", "Added normalize_name() method for automatic name normalization", "Added get_all_standard_names() method" ], "lines_added": 97, "lines_removed": 0 }, { "file": "generators/changelog_generator.py", "changes": [ "Added AI name normalization logic (lines 186-190)", "Modified contributors assignment for new version entries (line 234)", "Added existing contributor normalization logic (lines 237-244)", "Added import for AIContributorNames class" ], "lines_added": 8, "lines_modified": 2, "lines_removed": 0 }, { "file": "coderef/changelog/schema.json", "changes": [ "Enhanced contributors field description", "Added guidance for standardized AI system names" ], "lines_added": 2, "lines_modified": 1, "lines_removed": 0 }, { "file": "server.py", "changes": [ "Updated contributors field description in MCP tool schema", "Added examples of standardized AI names" ], "lines_added": 1, "lines_modified": 1, "lines_removed": 0 }, { "file": "tool_handlers.py", "changes": [ "Updated example contributor name in tool instructions", "Added guidance for standardized AI names" ], "lines_added": 1, "lines_modified": 1, "lines_removed": 0 } ], "test_entries_created": [ { "version": "1.4.2", "change_id": "change-018", "title": "Implement Standardized AI Contributor Naming System", "contributors": ["Claude (Anthropic)"] }, { "version": "1.4.2", "change_id": "change-019", "title": "Test AI Name Normalization System", "contributors": ["claude", "chatgpt", "gemini", "cursor", "copilot"] }, { "version": "1.4.2", "change_id": "change-020", "title": "Test Improved AI Name Normalization", "contributors": ["claude-code-ai", "gpt-4", "bard"] }, { "version": "1.4.3", "change_id": "change-021", "title": "Final AI Name Normalization Test", "contributors": ["claude", "chatgpt", "gemini"] }, { "version": "1.4.4", "change_id": "change-022", "title": "Test Fixed AI Name Normalization", "contributors": ["claude", "chatgpt", "gemini"] }, { "version": "1.4.5", "change_id": "change-023", "title": "Test After Indentation Fix", "contributors": ["claude", "chatgpt", "gemini"] }, { "version": "1.4.6", "change_id": "change-024", "title": "Debug Normalization Test", "contributors": ["claude", "chatgpt"] }, { "version": "1.4.7", "change_id": "change-025", "title": "Test Fixed Contributors Assignment", "contributors": ["claude", "chatgpt"] }, { "version": "1.4.8", "change_id": "change-026", "title": "Test AI Normalization After Server Restart", "contributors": ["claude", "chatgpt", "gemini", "cursor", "copilot"] } ], "revert_instructions": { "step_1": "Remove AIContributorNames class from constants.py (lines 177-273)", "step_2": "Remove normalization logic from changelog_generator.py (lines 186-190, 237-244)", "step_3": "Revert contributors assignment in changelog_generator.py (line 234)", "step_4": "Revert schema.json contributors field description", "step_5": "Revert server.py contributors field description", "step_6": "Revert tool_handlers.py example contributor name", "step_7": "Remove test changelog entries (versions 1.4.2-1.4.8)", "step_8": "Restart MCP server" }, "implementation_details": { "ai_systems_supported": [ "Claude (Anthropic)", "ChatGPT (OpenAI)", "Gemini (Google)", "Cursor AI", "GitHub Copilot", "Codex (OpenAI)", "AI Assistant (Generic)" ], "normalization_features": [ "Automatic name normalization", "Handles common variations and aliases", "Fallback to generic AI Assistant", "Preserves human names unchanged", "Case-insensitive matching" ], "technical_approach": [ "Added AIContributorNames class with comprehensive mapping", "Modified changelog generator to normalize names automatically", "Updated MCP tool schemas with naming guidance", "Enhanced error handling and validation" ] }, "notes": { "implementation_status": "COMPLETED_BUT_NOT_WORKING", "issue_identified": "MCP server not picking up code changes - normalization not applied to actual changelog entries", "root_cause": "Server restart required to load updated modules", "verification": "Normalization function tested and working correctly in isolation", "next_steps": "Revert changes as requested by user" } }