Skip to content

Commit 627a5c3

Browse files
phernandezclaude
andcommitted
docs: add comprehensive v0.14.0 changelog entry
Add detailed changelog for v0.14.0 release including: - Docker Container Registry migration to GitHub Container Registry - Enhanced search documentation with comprehensive syntax examples - Cross-project file management with intelligent boundary detection - 8 major bug fixes with issue numbers and commit links - Technical improvements and infrastructure enhancements - Migration guide and installation instructions Covers all changes since v0.13.7 with proper categorization and user-facing descriptions for better release communication. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: phernandez <paul@basicmachines.co>
1 parent cd88945 commit 627a5c3

1 file changed

Lines changed: 132 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,138 @@
11
# CHANGELOG
22

3+
## v0.14.0 (2025-06-26)
34

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+
```
4136

5137
## v0.13.7 (2025-06-19)
6138

0 commit comments

Comments
 (0)