v0.0.25

🐛 CodeTide v0.0.25 – Release Notes (2025-07-20)

🧹 Bug Fix Release
This version includes a small but important fix related to JSON serialization with orjson.

---

🐞 Bug Fixes

• Fixed a bug where orjson.dumps returned bytes instead of a string, causing issues in some components expecting str output.
• This ensures smoother integration when using serialization in CLI output, agent responses, or context handling.

---

Full Changelog: v0.0.24...v0.0.25

v0.0.24

🚀 CodeTide v0.0.24 – Release Notes (2025-07-19)

💻 Introducing the CodeTide CLI
This release brings a lightweight command-line interface, making it easier to invoke CodeTide functionality directly from the terminal.

---

🆕 New Feature

🔧 Command-Line Interface (CLI)

• Introduced CLI support for CodeTide via console_scripts.
• Enables access to core functions like context extraction and patch handling.
• Available through the codetide-cli entry point.

---

📦 Packaging

• CLI is bundled with the package and exposed through setup.py and pyproject.toml.
• Example usage:

  uvx --from codetide codetide-cli -h

---

🔭 Coming Soon

• CLI extensions for patch validation, agent workflows, and full project automation.

---

Full Changelog: v0.0.23...v0.0.24

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

v0.0.22

🚀 CodeTide v0.0.22 – 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.21...v0.0.22

v0.0.21

🌀 CodeTide v0.0.21 – TypeScript Beta & Smarter Code Completion (2025-06-29)

This release brings beta support for TypeScript, making CodeTide a multi-language parser powered by Tree-sitter, while preserving its local-first, LLM-free philosophy. We've also introduced stricter policies for smarter, safer autocomplete behavior and boosted test coverage for the new features.

---

✨ New Features

• 🧩 TypeScript Support (Beta):

  • Introduced TypeScriptParser, extending the BaseParser interface for symbolic TypeScript analysis.
  • Parses .ts files into structured class, method, and import data using Tree-sitter.
  • Enables hierarchy-aware navigation and code understanding for TypeScript projects.
  • Full integration with serialization, context extraction, and architecture tree views.

---

🔧 Improvements

• 🔍 Import Handling:

  • Enhanced processing of TypeScript imports, improving accuracy for cross-file and aliased imports.

• ✅ Code Context Improvements::

  • Introduced Slim Mode for efficient context retireval.
  • Added support for docstrings parsing

---

🧪 Tests & Stability

• 🧪 TypeScriptParser Unit Tests:

  • Comprehensive test suite validating parser correctness and edge-case handling.
  • Includes file parsing, element resolution, and reference extraction.

---

🗂️ Misc

• Updated README to reflect multi-language capabilities and highlight TypeScript support as Beta.

---

🛠 Upgrade Now

pip install codetide --upgrade

---

CodeTide continues to evolve into a powerful, language-aware platform for private, local-first code analysis. More languages coming soon.

v0.0.2

🚀 CodeTide v0.0.2 – Release Notes (2025-06-21)

🆕 Now Available as a VSCode Extension!
CodeTide is officially live on the Visual Studio Code Marketplace!

✨ Instantly bring structural code awareness into your editor:

• Navigate code intelligently
• Retrieve context-aware snippets
• Send structured context directly to LLMs (Copilot, GPT, etc.)
• Works seamlessly alongside your favorite extensions

🔗 Install Now: CodeTide on Marketplace
🛠️ Source Code: GitHub Repository

---

🆕 New Features

• File Change Tracking & Update Detection
  Added granular file change tracking via timestamps and a _get_changed_files method. The new check_for_updates() method enables efficient cache invalidation and dependency updates.

• Improved Serialization & Deserialization

  • Custom file paths are now supported.
  • Integration with .gitignore and store_in_project_root logic.
  • Conditional serialization toggle added to check_for_updates().

• Git Integration via pygit2
  Enhanced file change tracking using pygit2, allowing better support for Git-based projects.

• Enhanced Context Structures

  • Introduced the preloaded attribute in CodeContextStructure.
  • Added functionality for file ID pre-checking and relative file path resolution.

• Logging Framework Integration
  Integrated loguru for structured logging and added persistent logs directory handling.

---

🔧 Enhancements & Refactors

• Improved Code Organization

  • Refactored file_list to a dictionary for better timestamp management.
  • Overhauled resolve_intra_file_dependencies and resolve_inter_files_dependencies for flexibility.

• Parser and Model Refinements

  • Updated PythonParser to better support relative imports and match count detection.
  • Renamed and clarified key properties like unique_ids, stored_unique_id, and definition_id.

• Serialization System Revamp

  • More accurate path extraction and defaults.
  • Simplified and clarified key methods and arguments.

• Import Logic Simplification
  Streamlined handling of import statements and standardized relative import usage.

• Context Handling Improvements

  • Flattened context lists for length checks.
  • Ensured safe handling of empty or missing context scenarios.

• Refined Initialization
  Refactored the CodeTide initialization process for cleaner logging and variable handling.

---

🧪 Tests & CI

• Added unit tests for:

  • File reading/writing
  • GenericParser and PythonParser
  • File detection and Git-based organization
  • CodeBase and related models

---

📝 Documentation & Examples

• Updated the README.md:

  • Enhanced project description and added badges.
  • Included a roadmap section.
  • Improved logo rendering.

• Added example scripts demonstrating CodeTide’s parsing and context extraction capabilities.

---

🐛 Bug Fixes

• Corrected path handling logic in BaseCodeElement.
• Fixed edge cases in file_path_without_suffix.
• Resolved context insertion issues when the context was empty.
• Patched default behavior when parser is None.
• Addressed inconsistencies in attribute naming and dictionary usage across modules.

---

⏳ Coming Soon

• TypeScript Support
  We're extending CodeTide’s language coverage! A new TypeScriptParser is in the works, bringing the same structural insight and symbolic parsing capabilities to TypeScript projects.
  → Built on Tree-sitter, just like Python.
  → Seamless integration with your existing CodeTide workflows.

v0.0.15

Enhance serialization in CodeTide by adding support for cached elemen…

v0.0.1

initial release for testing purposes

What's Changed

• V2 by @BrunoV21 in #1

Full Changelog: https://github.com/BrunoV21/CodeTide/commits/v0.0.1