Release Notes - v0.5.5

Release Date: 2026-03-14 Changes: v0.5.5.dev0 → main

Pull Requests: [#2288]

Summary

Release 0.5.5 brings a major push around DLT ingestion (new MVP, safety and robustness), an important memify change to use triplet embeddings by default, and multiple CI/docs automation and bug fixes. This release focuses on enabling reliable ingestion from DLT sources, improving developer workflows, and tightening up stability across examples and tests.

Highlights

• DLT ingestion MVP for Postgres with full supporting modules and example usage
• Memify default pipeline now uses triplet embeddings for better semantic matching
• Hardened DLT ingestion: SQL safety, async handling, concurrency controls, and error handling improvements
• New CI/docs automation: install_cognee action, more flexible test workflows, and automatic docs sync on releases
• Numerous bug fixes and Windows Docker entrypoint and Swagger UI fixes

Breaking Changes

• Memify default pipeline now uses triplet embeddings instead of coding rules — this can change embedding vectors, similarity results, and downstream retrieval behavior. Review any custom memify pipelines or expectations when upgrading.
• DLT ingestion default write disposition changed to 'replace'. Existing destinations may be overwritten by ingestion runs unless explicitly configured otherwise. Double-check your DLT ingestion settings before running against production destinations.
• Destination creation for DLT ingestion now uses dlt_db_name instead of db_name in relational configs — users who relied on the old db_name behavior may need to update configurations.
• Releases created from the 'dev' branch are now marked as pre-releases by automation; if you rely on non-prerelease tags from dev, adjust your workflow.

New Features

• DLT ingestion support: added ingestion pipeline, source resolution, destination creation, FK extraction, and example demo (Postgres destination)
• Memify: replaced coding rules with triplet embedding in the default memify pipeline to improve embedding quality and retrieval
• Docs automation: sync Mintlify docs on published releases and a new tool to sync OpenAPI and changelog (tools/sync_release_docs.py)
• New GitHub composite action to install Cognee in CI (supports local install or specific PyPI version)

Improvements

• DLT ingestion hardened for SQL safety, async execution, concurrency, and orphan row logic
• DLT ingestion usability: resolve relative SQLite paths, recognize DltSource types, use dlt_db_name for destination creation, and default write disposition set to 'replace'
• Validated file paths and surfaced errors in the MCP cognify tool to avoid silent failures
• Added DLT_MAX_ROWS_PER_TABLE to .env.template (commented) to control how many rows are read per table during DLT ingestion
• CI improvements: CLI and MCP test workflows support installing a specific Cognee version and use the new install_cognee action; dev releases are marked as pre-releases in automation
• Repository hygiene: enforced LF for shell scripts (.gitattributes) to fix Docker entrypoint issues on Windows, and various code formatting and lockfile updates

Bug Fixes

• Fixed Swagger UI issue and several test assertion failures
• Guarded against None tracer in new_span() to avoid crashes in observability code
• Fixed Docker entrypoint failing on Windows by ensuring LF line endings and related Dockerfile adjustments
• Fixed many DLT-related ingestion bugs: DataItem ingestion, write disposition handling, import issues, and recognition of DltSource in resolution
• Replaced broad exception handlers with narrower ones in task code, improved NotImplementedError messages, and removed mutable default arguments to avoid subtle bugs
• Fixed community greeting workflow to skip bot/Claude Code PRs and corrected parameter names for actions/first-interaction@v3

Technical Changes

• Consolidated DLT logic into a single resolve_dlt_sources adapter and added many new DLT modules (ingest_dlt_source, create_dlt_source, dlt_utils, extract_dlt_fk_edges, etc.) and example data under examples/demos/dlt_ingestion_example.py
• Added tools/sync_release_docs.py to automate OpenAPI and changelog sync to the docs repository on release
• Added .github/actions/install_cognee/action.yml (composite action) and updated multiple GitHub workflows to support passing cognee_version and installing local or specific PyPI versions
• Updated dependencies and lockfiles to resolve vulnerabilities and modernize the test/deploy stacks
• Misc: refactors, type/typing fixes, circular import fixes, and formatting changes across the codebase

Generated by Cognee Release Notes Generator on 2026-03-14