v0.0.23

🚀 CodeTide v0.0.23 – Release Notes (2025-07-20)

🧠 Introducing MCP & AgentTide: Context-Aware AI Integration for CodeTide
This release brings MCP (Model Context Protocol) and an embedded agent, AgentTide, turning CodeTide into a powerful platform for context-aware AI development and automation.

🧩 CodeTide now supports TypeScript (Beta) alongside Python, making it easier to build AI-native dev tools across languages.

🧪 Includes hundreds of tests and dozens of enhancements across parsing, context generation, patching, and agent interaction.

---

🆕 New Features

🤖 AgentTide: Embedded LLM Agent for Structural Code Refactoring

• Introduces AgentTide, a CLI-based AI agent built on FastMCP, powered by structured context from CodeTide.
• Enables LLM-powered code refactoring using precise context and interactive prompts.
• Fully async, testable, and includes patch handling via structured inputs.

🔌 MCP Server (Model Context Protocol)

• Adds a built-in server powered by FastMCP, exposing CodeTide’s capabilities over stdin/stdout.
• CLI script codetide-mcp-server now available via setup.py entrypoint.
• New usage examples and documentation for integrating with AI agents.

🛠️ Patch Processing Utilities

• New applyPatch function for applying generated code changes.
• Utilities for parsing structured patch formats (parse_patch_blocks), handling XML-style metadata, and robust error handling.
• Support for temporary patch files, validation, and line-specific context extraction.

---

🌐 TypeScript Support (Beta)

• Added TypeScriptParser built on tree-sitter-typescript.

• Supports parsing of:

  • Classes, interfaces, functions, type aliases, imports, and decorators.
  • Intra-file dependency resolution with contextual references.

• Includes full test coverage with edge cases and semantic validation.

• Exposed via CodeTide just like the Python parser.

---

🧠 Context Enhancements

• Improved getCodeContext() (formerly getContext()) with stricter argument validation, better error messages, and new usage guidelines.

• Added slim mode for minimal context retrieval.

• Enhanced CodeContextStructure:

  • Support for class headers, type hints, and raw context formatting.
  • Improved trimming and indentation logic.

• FunctionSignature and ClassDefinition now include detailed docstrings and header formatting.

---

🧪 Tests & Stability

• Comprehensive test coverage for:

  • TypeScript parsing, decorators, imports, and interface declarations.
  • Patch application and context reconstruction.
  • Agent prompt handling and interaction flow.

• Enhanced CI with agent tests toggle (requirements-agents.txt, pytest config).

---

🔧 Enhancements & Refactors

• CodeBase & Parser Improvements

  • Unified intra-file dependency resolution across Python and TypeScript.
  • Better handling of docstrings, decorators, modifiers, and export statements.
  • Enhanced identifier validation and suggestion logic.

• Documentation & Developer Experience

  • ASCII headers for CodeTide and AgentTide for better CLI UX.
  • Refined prompts and system messages for agents.
  • Enhanced and standardized docstrings across modules.
  • Added CONTRIBUTING.md and clarified project philosophy.

• Performance Improvements

  • Switched to orjson for fast serialization.
  • Cached IDs for context reuse.
  • Streamlined data structure for context and references.

---

📦 Packaging & Tooling

• Introduced pyproject.toml and uv.lock for modern dependency and script management.

• New script entrypoint:

  codetide-mcp-server

  Runs the CodeTide MCP server via CLI.

• Added requirements-agents.txt for optional agent dependencies (core-for-ai, etc.).

---

🐛 Bug Fixes

• Fixed parameter references in interface and import processing.
• Resolved formatting issues in test assertions and context outputs.
• Removed unused debug prints and redundant imports.
• Ensured proper newline handling and patch safety.

---

📝 Documentation & Examples

• Revamped README.md with:

  • MCP and AgentTide instructions.
  • Patch format documentation and LLM usage notes.
  • Updated contributing section.

• Added example script for using AgentTide in real projects.

• New AgentTide Disclaimer section explaining scope and current limitations.

---

⏳ Coming Soon

• 🧪 Test-Driven Code Validation for AgentTide

  • Terminal execution and test running planned for next version.

• 🌍 Additional Language Support

  • More languages via tree-sitter in the roadmap.

• 🧱 VSCode Integration for Agents

  • Deeper embedding of agents in IDE workflows.

What's Changed

• Mcp server by @BrunoV21 in #5

Full Changelog: v0.0.22...v0.0.23