🚀 GitHub Second Brain v2.1.0

✨ New Features

🔍 Code Diff Analysis Tool

• NEW: get_code_diff tool for comprehensive diff analysis (#52)
  • Compare any two commits, branches, or tags
  • Analyze pull request changes
  • Perfect for understanding code evolution and reviewing changes

🎯 Enhanced User Experience

• NEW: Built-in prompt system with comprehensive tool usage guidance (#59)
• FIX: Renamed get_file_contents to get_repo_contents (avoiding conflicts with official GitHub MCP) (#58)
• UPDATED: Enhanced documentation with clearer tool descriptions

🛠️ Technical Improvements

• Enhanced error handling with custom GitHubApiError class
• Better code organization with separated prompt logic
• Improved pull request template with documentation requirements

📚 Documentation Updates

• Updated README with new tool documentation
• New project launch video
• Improved acknowledgments and references

🔧 Breaking Changes

• Tool name change: get_file_contents → get_repo_contents

---

Full Changelog: v2.0.0...v2.1.0

🎉 Major Refactor – v2.0.0

This release introduces a complete architectural overhaul of GitHub Second Brain, making it more modular, maintainable, and future-proof. All new development will continue from this version forward.

---

✨ What’s New

• Self-contained MCP Server:
  The MCP server is now implemented directly in mcp/main.py, removing the need for a separate FastAPI backend. This results in a simpler, more robust, and easier-to-deploy system.

• Async & Modern Python:
  The new server uses httpx for async HTTP requests and leverages Pydantic for type safety and validation.

• Modular Tooling:
  All tools (directory tree, file contents, issue context) are now organized in mcp/tools/, making it much easier to extend and maintain.

• Simplified Dependencies:
  Unnecessary dependencies have been removed. The project now relies on fastmcp and pydantic for a leaner, more reliable stack.

• Improved Error Handling:
  Enhanced error messages and validation for a better developer and user experience.

• Clear Documentation & Migration Guidance:
  The README has been updated to reflect the new architecture, with clear instructions for both new and legacy users. New issue templates are also added and documented

---

🏷️ Branches

• main: This branch contains the new, refactored codebase (v2.0.0+).
• legacy/v1-archive: The old architecture is preserved here for users who need it.

---

🚨 Migration & Support

• Legacy users:
  If you need the old FastAPI-based architecture, use the legacy/v1-archive branch or the v1.0.0-legacy release.

• New users:
  Use the main branch for the latest features, performance, and support.

• Migration guide:
  See the README for details.

---

📝 Notes

• Please report any issues or suggestions via GitHub Issues.
• For legacy support, mention v1.0.0-legacy in your issue.

---

Thank you for your support and contributions to GitHub Second Brain!

What's Changed

• Closes #42: Update README.md by @BaoNguyen09 in #48
• Closes #42: move all the logic from the fastapi server to within the mcp server container by @BaoNguyen09 in #47

Full Changelog: v1.0.0-legacy...v2.0.0

Legacy v1.x Archive (Pre-Refactor)

This release marks the final state of the original GitHub Second Brain architecture before the major refactor.

---

🏷️ Branches

• legacy/v1-archive: This branch contains the legacy v1.x codebase and will receive no further updates except for critical fixes if necessary.
• main: All new development, including the major refactor, will continue here.

---

🔄 What’s Changed in the Refactor?

• Removed the app/ directory: The FastAPI backend and its internal tools are no longer part of the main codebase.
• Self-contained MCP server: The MCP server is now implemented directly in mcp/main.py, with async support and improved error handling.
• Modular tool design: Tools are now organized in mcp/tools/, making it easier to add new features and maintain the codebase.
• Simplified dependencies: The new version removes unnecessary dependencies and uses modern async libraries.
• Improved documentation: The README now clearly explains the new architecture, branch structure, and migration guidance.

---

🚨 Migration & Support

• Legacy users: You can continue to use this release/branch if you need the old architecture with FastAPI backend.
• New users: Please use the main branch for the latest features and improvements.
• Migration guide: See the README for details.

---

📝 Notes

• This release is intended for users who need to maintain compatibility with the pre-refactor codebase.
• For bug reports or issues with the legacy version, please mention v1.0.0-legacy in your issue.

---

Thank you for using and contributing to github-second-brain!