|
1 | 1 | # CHANGELOG |
2 | 2 |
|
| 3 | +## v0.14.0 (2025-06-26) |
3 | 4 |
|
| 5 | +### Features |
| 6 | + |
| 7 | +- **Docker Container Registry Migration** - Switch from Docker Hub to GitHub Container Registry for better security and integration |
| 8 | + ([`616c1f0`](https://github.com/basicmachines-co/basic-memory/commit/616c1f0710da59c7098a5f4843d4f017877ff7b2)) |
| 9 | + - Automated Docker image publishing via GitHub Actions CI/CD pipeline |
| 10 | + - Enhanced container security with GitHub's integrated vulnerability scanning |
| 11 | + - Streamlined container deployment workflow for production environments |
| 12 | + |
| 13 | +- **Enhanced Search Documentation** - Comprehensive search syntax examples for improved user experience |
| 14 | + ([`a589f8b`](https://github.com/basicmachines-co/basic-memory/commit/a589f8b894e78cce01eb25656856cfea8785fbbf)) |
| 15 | + - Detailed examples for Boolean search operators (AND, OR, NOT) |
| 16 | + - Advanced search patterns including phrase matching and field-specific queries |
| 17 | + - User-friendly documentation for complex search scenarios |
| 18 | + |
| 19 | +- **Cross-Project File Management** - Intelligent move operations with project boundary detection |
| 20 | + ([`db5ef7d`](https://github.com/basicmachines-co/basic-memory/commit/db5ef7d35cc0894309c7a57b5741c9dd978526d4)) |
| 21 | + - Automatic detection of cross-project move attempts with helpful guidance |
| 22 | + - Clear error messages when attempting unsupported cross-project operations |
| 23 | + |
| 24 | +### Bug Fixes |
| 25 | + |
| 26 | +- **#184**: Preserve permalinks when editing notes without frontmatter permalinks |
| 27 | + ([`c2f4b63`](https://github.com/basicmachines-co/basic-memory/commit/c2f4b632cf04921b1a3c2f0d43831b80c519cb31)) |
| 28 | + - Fix permalink preservation during note editing operations |
| 29 | + - Ensure consistent permalink handling across different note formats |
| 30 | + - Maintain note identity and searchability during incremental edits |
| 31 | + |
| 32 | +- **#183**: Implement project-specific sync status checks for MCP tools |
| 33 | + ([`12b5152`](https://github.com/basicmachines-co/basic-memory/commit/12b51522bc953fca117fc5bc01fcb29c6ca7e13c)) |
| 34 | + - Fix sync status reporting to correctly reflect current project state |
| 35 | + - Resolve inconsistencies where sync status showed global instead of project-specific information |
| 36 | + - Improve project isolation for sync operations and status reporting |
| 37 | + |
| 38 | +- **#180**: Handle Boolean search syntax with hyphenated terms |
| 39 | + ([`546e3cd`](https://github.com/basicmachines-co/basic-memory/commit/546e3cd8db98b74f746749d41887f8a213cd0b11)) |
| 40 | + - Fix search parsing issues with hyphenated terms in Boolean queries |
| 41 | + - Improve search query tokenization for complex term structures |
| 42 | + - Enhanced search reliability for technical documentation and multi-word concepts |
| 43 | + |
| 44 | +- **#174**: Respect BASIC_MEMORY_HOME environment variable in Docker containers |
| 45 | + ([`9f1db23`](https://github.com/basicmachines-co/basic-memory/commit/9f1db23c78d4648e2c242ad1ee27eed85e3f3b5d)) |
| 46 | + - Fix Docker container configuration to properly honor custom home directory settings |
| 47 | + - Improve containerized deployment flexibility with environment variable support |
| 48 | + - Ensure consistent behavior between local and containerized installations |
| 49 | + |
| 50 | +- **#168**: Scope entity queries by project_id in upsert_entity method |
| 51 | + ([`2a3adc1`](https://github.com/basicmachines-co/basic-memory/commit/2a3adc109a3e4d7ccd65cae4abf63d9bb2338326)) |
| 52 | + - Fix entity isolation issues in multi-project setups |
| 53 | + - Prevent cross-project entity conflicts during database operations |
| 54 | + - Strengthen project boundary enforcement at the database level |
| 55 | + |
| 56 | +- **#166**: Handle None from_entity in Context API RelationSummary |
| 57 | + ([`8a065c3`](https://github.com/basicmachines-co/basic-memory/commit/8a065c32f4e41613207d29aafc952a56e3a52241)) |
| 58 | + - Fix null pointer exceptions in relation processing |
| 59 | + - Improve error handling for incomplete relation data |
| 60 | + - Enhanced stability for knowledge graph traversal operations |
| 61 | + |
| 62 | +- **#164**: Remove log level configuration from mcp_server.run() |
| 63 | + ([`224e4bf`](https://github.com/basicmachines-co/basic-memory/commit/224e4bf9e4438c44a82ffc21bd1a282fe9087690)) |
| 64 | + - Simplify MCP server startup by removing redundant log level settings |
| 65 | + - Fix potential logging configuration conflicts |
| 66 | + - Streamline server initialization process |
| 67 | + |
| 68 | +- **#162**: Ensure permalinks are generated for entities with null permalinks during move operations |
| 69 | + ([`f506507`](https://github.com/basicmachines-co/basic-memory/commit/f50650763dbd4322c132e4bdc959ce4bf074374b)) |
| 70 | + - Fix move operations for entities without existing permalinks |
| 71 | + - Automatic permalink generation during file move operations |
| 72 | + - Maintain database consistency during file reorganization |
| 73 | + |
| 74 | +### Technical Improvements |
| 75 | + |
| 76 | +- **Comprehensive Test Coverage** - Extensive test suites for new features and edge cases |
| 77 | + - Enhanced test coverage for project-specific sync status functionality |
| 78 | + - Additional test scenarios for search syntax validation and edge cases |
| 79 | + - Integration tests for Docker CI workflow and container publishing |
| 80 | + - Comprehensive move operations testing with project boundary validation |
| 81 | + |
| 82 | +- **Docker CI/CD Pipeline** - Production-ready automated container publishing |
| 83 | + ([`74847cc`](https://github.com/basicmachines-co/basic-memory/commit/74847cc3807b0c6ed511e0d83e0d560e9f07ec44)) |
| 84 | + - Automated Docker image building and publishing on release |
| 85 | + - Multi-architecture container support for AMD64 and ARM64 platforms |
| 86 | + - Integrated security scanning and vulnerability assessments |
| 87 | + - Streamlined deployment pipeline for production environments |
| 88 | + |
| 89 | +- **Release Process Improvements** - Enhanced automation and quality gates |
| 90 | + ([`a52ce1c`](https://github.com/basicmachines-co/basic-memory/commit/a52ce1c8605ec2cd450d1f909154172cbc30faa2)) |
| 91 | + - Homebrew formula updates limited to stable releases only |
| 92 | + - Improved release automation with better quality control |
| 93 | + - Enhanced CI/CD pipeline reliability and error handling |
| 94 | + |
| 95 | +- **Code Quality Enhancements** - Improved error handling and validation |
| 96 | + - Better null safety in entity and relation processing |
| 97 | + - Enhanced project isolation validation throughout the codebase |
| 98 | + - Improved error messages and user guidance for edge cases |
| 99 | + - Strengthened database consistency guarantees across operations |
| 100 | + |
| 101 | +### Infrastructure |
| 102 | + |
| 103 | +- **GitHub Container Registry Integration** - Modern container infrastructure |
| 104 | + - Migration from Docker Hub to GitHub Container Registry (ghcr.io) |
| 105 | + - Improved security with integrated vulnerability scanning |
| 106 | + - Better integration with GitHub-based development workflow |
| 107 | + - Enhanced container versioning and artifact management |
| 108 | + |
| 109 | +- **Enhanced CI/CD Workflows** - Robust automated testing and deployment |
| 110 | + - Automated Docker image publishing on releases |
| 111 | + - Comprehensive test coverage validation before deployment |
| 112 | + - Multi-platform container building and publishing |
| 113 | + - Integration with GitHub's security and monitoring tools |
| 114 | + |
| 115 | +### Migration Guide |
| 116 | + |
| 117 | +This release includes several behind-the-scenes improvements and fixes. All changes are backward compatible: |
| 118 | + |
| 119 | +- **Docker Users**: Container images now served from `ghcr.io/basicmachines-co/basic-memory` instead of Docker Hub |
| 120 | +- **Search Users**: Enhanced search syntax handling - existing queries continue to work unchanged |
| 121 | +- **Multi-Project Users**: Improved project isolation - all existing projects remain fully functional |
| 122 | +- **All Users**: Enhanced stability and error handling - no breaking changes to existing workflows |
| 123 | + |
| 124 | +### Installation |
| 125 | + |
| 126 | +```bash |
| 127 | +# Latest stable release |
| 128 | +uv tool install basic-memory |
| 129 | + |
| 130 | +# Update existing installation |
| 131 | +uv tool upgrade basic-memory |
| 132 | + |
| 133 | +# Docker (new registry) |
| 134 | +docker pull ghcr.io/basicmachines-co/basic-memory:latest |
| 135 | +``` |
4 | 136 |
|
5 | 137 | ## v0.13.7 (2025-06-19) |
6 | 138 |
|
|
0 commit comments