basic-memory 0.15.2__tar.gz → 0.16.1__tar.gz

{basic_memory-0.15.2 → basic_memory-0.16.1}/.github/workflows/claude-code-review.yml

@@ -71,9 +71,12 @@ jobs:
             - [ ] Proper error handling and logging
             - [ ] Performance considerations addressed
             - [ ] No sensitive data in logs or commits
+            
+            ## Compatability
+            - [ ] File path comparisons must be windows compatible
+            - [ ] Avoid using emojis and unicode characters in console and log output
 
             Read the CLAUDE.md file for detailed project context. For each checklist item, verify if it's satisfied and comment on any that need attention. Use inline comments for specific code issues and post a summary with checklist results.
 
           # Allow broader tool access for thorough code review
           claude_args: '--allowed-tools "Bash(gh pr:*),Bash(gh issue:*),Bash(gh api:*),Bash(git log:*),Bash(git show:*),Read,Grep,Glob"'
-

{basic_memory-0.15.2 → basic_memory-0.16.1}/CHANGELOG.md

@@ -1,5 +1,250 @@
 # CHANGELOG
 
+## v0.16.1 (2025-11-11)
+
+### Bug Fixes
+
+- **#422**: Handle Windows line endings in rclone bisync
+  ([`e9d0a94`](https://github.com/basicmachines-co/basic-memory/commit/e9d0a94))
+  - Added `--compare=modtime` flag to rclone bisync to ignore size differences from line ending conversions
+  - Fixes issue where LF→CRLF conversion on Windows was treated as file corruption
+  - Resolves "corrupted on transfer: sizes differ" errors during cloud sync on Windows
+  - Users will need to run `--resync` once after updating to establish new baseline
+
+## v0.16.0 (2025-11-10)
+
+### Features
+
+- **#417**: Add run_in_background parameter to sync endpoint
+  ([`7ccec7e`](https://github.com/basicmachines-co/basic-memory/commit/7ccec7e))
+  - New `run_in_background` parameter for async sync operations
+  - Improved API flexibility for long-running sync tasks
+  - Comprehensive test coverage for background sync behavior
+
+- **#405**: SPEC-20 Simplified Project-Scoped Rclone Sync
+  ([`0b3272a`](https://github.com/basicmachines-co/basic-memory/commit/0b3272a))
+  - Simplified and more reliable cloud synchronization
+  - Project-scoped rclone configuration
+  - Better error handling and status reporting
+
+- **#384**: Streaming Foundation & Async I/O Consolidation (SPEC-19)
+  ([`e78345f`](https://github.com/basicmachines-co/basic-memory/commit/e78345f))
+  - Foundation for streaming support in future releases
+  - Consolidated async I/O patterns across codebase
+  - Improved performance and resource management
+
+- **#364**: Add circuit breaker for file sync failures
+  ([`434cdf2`](https://github.com/basicmachines-co/basic-memory/commit/434cdf2))
+  - Prevents cascading failures during sync operations
+  - Automatic recovery from transient errors
+  - Better resilience in cloud sync scenarios
+
+- **#362**: Add --verbose and --no-gitignore options to cloud upload
+  ([`7f9c1a9`](https://github.com/basicmachines-co/basic-memory/commit/7f9c1a9))
+  - Enhanced upload control with verbose logging
+  - Option to bypass gitignore filtering when needed
+  - Better debugging and troubleshooting capabilities
+
+- **#391**: Add delete_notes parameter to remove project endpoint
+  ([`c9946ec`](https://github.com/basicmachines-co/basic-memory/commit/c9946ec))
+  - Option to delete notes when removing projects
+  - Safer project cleanup workflows
+  - Prevents accidental data loss
+
+### Bug Fixes
+
+- **#420**: Skip archive files during cloud upload
+  ([`49b2adc`](https://github.com/basicmachines-co/basic-memory/commit/49b2adc))
+  - Prevents uploading of zip, tar, gz and other archive files
+  - Reduces storage usage and upload time
+  - Better file filtering during cloud operations
+
+- **#419**: Rename write_note entity_type to note_type for clarity
+  ([`1646572`](https://github.com/basicmachines-co/basic-memory/commit/1646572))
+  - Clearer parameter naming in write_note tool
+  - Improved API consistency and documentation
+  - Better developer experience
+
+- **#418**: Quote string values in YAML frontmatter to handle special characters
+  ([`f0d7398`](https://github.com/basicmachines-co/basic-memory/commit/f0d7398))
+  - Fixes YAML parsing errors with special characters
+  - More robust frontmatter handling
+  - Prevents data corruption in edge cases
+
+- **#415**: Handle dict objects in write_resource endpoint
+  ([`4614fd0`](https://github.com/basicmachines-co/basic-memory/commit/4614fd0))
+  - Fixes errors when writing dictionary resources
+  - Better type handling in resource endpoints
+  - Improved API robustness
+
+- **#414**: Replace Unicode arrows with ASCII for Windows compatibility
+  ([`fc01f6a`](https://github.com/basicmachines-co/basic-memory/commit/fc01f6a))
+  - Fixes display issues on Windows terminals
+  - Better cross-platform compatibility
+  - Improved CLI user experience on Windows
+
+- **#411**: Windows CLI Unicode encoding errors
+  ([`0ba6f21`](https://github.com/basicmachines-co/basic-memory/commit/0ba6f21))
+  - Resolves Unicode encoding issues on Windows
+  - Better handling of international characters
+  - Improved Windows platform support
+
+- **#410**: Various rclone fixes for cloud sync on Windows
+  ([`c9946ec`](https://github.com/basicmachines-co/basic-memory/commit/c9946ec))
+  - Fixes cloud sync reliability on Windows
+  - Better path handling for Windows filesystem
+  - Improved rclone integration on Windows
+
+- **#402**: Normalize YAML frontmatter types to prevent AttributeError
+  ([`a7d7cc5`](https://github.com/basicmachines-co/basic-memory/commit/a7d7cc5))
+  - Fixes AttributeError when reading frontmatter
+  - More robust type normalization
+  - Better error handling in markdown parsing
+
+- **#396**: Strip duplicate headers in edit_note replace_section
+  ([`021af74`](https://github.com/basicmachines-co/basic-memory/commit/021af74))
+  - Prevents duplicate headers when replacing sections
+  - Cleaner note editing behavior
+  - Better content consistency
+
+- **#395**: Simplify search_notes schema by removing Optional wrappers
+  ([`d775f7b`](https://github.com/basicmachines-co/basic-memory/commit/d775f7b))
+  - Cleaner API schema definition
+  - Better type safety and validation
+  - Improved developer experience
+
+- **#394**: Add explicit type annotations to MCP tool parameters
+  ([`581b7b1`](https://github.com/basicmachines-co/basic-memory/commit/581b7b1))
+  - Better type safety in MCP tools
+  - Improved IDE support and autocomplete
+  - Clearer tool documentation
+
+- **#389**: Handle null, empty, and string 'None' title in markdown frontmatter
+  ([`bb8da31`](https://github.com/basicmachines-co/basic-memory/commit/bb8da31))
+  - Fixes errors with malformed frontmatter titles
+  - More robust title handling
+  - Better error recovery
+
+- **#380**: Optimize sync memory usage to prevent OOM on large projects
+  ([`4fd6d0c`](https://github.com/basicmachines-co/basic-memory/commit/4fd6d0c))
+  - Prevents out-of-memory errors on large knowledge bases
+  - Better memory management during sync
+  - Improved scalability
+
+- **#379**: Handle YAML parsing errors gracefully in update_frontmatter
+  ([`32236cd`](https://github.com/basicmachines-co/basic-memory/commit/32236cd))
+  - Better error handling for malformed YAML
+  - Graceful degradation instead of crashes
+  - Improved robustness
+
+- **#377**: Preserve mtime on WebDAV upload
+  ([`e6c8e36`](https://github.com/basicmachines-co/basic-memory/commit/e6c8e36))
+  - Maintains file modification times during upload
+  - Better sync accuracy
+  - Prevents unnecessary re-syncing
+
+- **#370**: Prevent deleted projects from being recreated by background sync
+  ([`449b62d`](https://github.com/basicmachines-co/basic-memory/commit/449b62d))
+  - Fixes race condition with project deletion
+  - Better lifecycle management
+  - Prevents unwanted project recreation
+
+- **#369**: Use filesystem timestamps for entity sync instead of database operation time
+  ([`b7497d7`](https://github.com/basicmachines-co/basic-memory/commit/b7497d7))
+  - More accurate sync detection
+  - Better handling of external file modifications
+  - Improved sync reliability
+
+- **#368**: Handle YAML parsing errors and missing entity_type in markdown files
+  ([`d1431bd`](https://github.com/basicmachines-co/basic-memory/commit/d1431bd))
+  - Better error handling for malformed markdown
+  - Graceful handling of missing metadata
+  - Improved robustness
+
+- **#367**: Resolve UNIQUE constraint violation in entity upsert with observations
+  ([`171bef7`](https://github.com/basicmachines-co/basic-memory/commit/171bef7))
+  - Fixes database constraint errors during sync
+  - Better handling of duplicate observations
+  - Improved data integrity
+
+- **#366**: Terminate sync immediately when project is deleted
+  ([`729a5a3`](https://github.com/basicmachines-co/basic-memory/commit/729a5a3))
+  - Faster project deletion
+  - Better resource cleanup
+  - Improved user experience
+
+- **#357**: Make project creation endpoint idempotent
+  ([`53fb13b`](https://github.com/basicmachines-co/basic-memory/commit/53fb13b))
+  - Prevents errors when creating existing projects
+  - Better API reliability
+  - Improved cloud integration
+
+- **#353**: Handle None text values in Claude conversations importer
+  ([`bd6c834`](https://github.com/basicmachines-co/basic-memory/commit/bd6c834))
+  - Fixes import errors with empty messages
+  - Better error handling in importers
+  - Improved data migration
+
+### Performance Improvements
+
+- Force full database sync after project sync/bisync operations
+  ([`2ad0ee9`](https://github.com/basicmachines-co/basic-memory/commit/2ad0ee9))
+  - Ensures database consistency after cloud operations
+  - Better sync reliability
+  - Improved data integrity
+
+### Documentation
+
+- Add free trial information to README
+  ([`a7d7cc5`](https://github.com/basicmachines-co/basic-memory/commit/a7d7cc5), [`8aaddb6`](https://github.com/basicmachines-co/basic-memory/commit/8aaddb6))
+  - Updated README with Basic Memory Cloud trial info
+  - Better onboarding experience
+  - Clearer pricing information
+
+- Announce Basic Memory Cloud launch in README
+  ([`d756531`](https://github.com/basicmachines-co/basic-memory/commit/d756531))
+  - Official cloud service announcement
+  - Updated documentation for cloud features
+  - Improved product positioning
+
+### Migration Guide
+
+No manual migration required. Upgrade with:
+
+```bash
+# Update via uv
+uv tool upgrade basic-memory
+
+# Or install fresh
+uv tool install basic-memory
+```
+
+**What's New in v0.16.0:**
+- Streaming foundation and consolidated async I/O (SPEC-19)
+- Simplified project-scoped rclone sync (SPEC-20)
+- Circuit breaker for sync failure resilience
+- Enhanced Windows platform support
+- Improved cloud upload with verbose and gitignore options
+- Better error handling across YAML parsing and frontmatter
+- Memory optimization for large projects
+- Archive file filtering during upload
+
+**Breaking Changes:**
+- `write_note` parameter renamed: `entity_type` → `note_type` for clarity
+
+### Installation
+
+```bash
+# Latest stable release
+uv tool install basic-memory
+
+# Update existing installation
+uv tool upgrade basic-memory
+
+# Docker
+docker pull ghcr.io/basicmachines-co/basic-memory:v0.16.0
+```
+
 ## v0.15.2 (2025-10-14)
 
 ### Features

{basic_memory-0.15.2 → basic_memory-0.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: basic-memory
-Version: 0.15.2
+Version: 0.16.1
 Summary: Local-first knowledge management combining Zettelkasten with knowledge graphs
 Project-URL: Homepage, https://github.com/basicmachines-co/basic-memory
 Project-URL: Repository, https://github.com/basicmachines-co/basic-memory
@@ -17,6 +17,7 @@ Requires-Dist: fastapi[standard]>=0.115.8
 Requires-Dist: fastmcp>=2.10.2
 Requires-Dist: greenlet>=3.1.1
 Requires-Dist: icecream>=2.1.3
+Requires-Dist: logfire>=0.73.0
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: markdown-it-py>=3.0.0
 Requires-Dist: mcp>=1.2.0
@@ -46,6 +47,16 @@ Description-Content-Type: text/markdown
 ![](https://badge.mcpx.dev?type=dev 'MCP Dev')
 [![smithery badge](https://smithery.ai/badge/@basicmachines-co/basic-memory)](https://smithery.ai/server/@basicmachines-co/basic-memory)
 
+## 🚀 Basic Memory Cloud is Live!
+
+- **Cross-device and multi-platform support is here.** Your knowledge graph now works on desktop, web, and mobile - seamlessly synced across all your AI tools (Claude, ChatGPT, Gemini, Claude Code, and Codex) 
+- **Early Supporter Pricing:** Early users get 25% off forever. 
+The open source project continues as always. Cloud just makes it work everywhere.
+
+[Sign up now →](https://basicmemory.com/beta)
+
+with a 7 day free trial
+
 # Basic Memory
 
 Basic Memory lets you build persistent knowledge through natural conversations with Large Language Models (LLMs) like
@@ -479,4 +490,4 @@ and submitting PRs.
  </picture>
 </a>
 
-Built with ♥️ by Basic Machines
+Built with ♥️ by Basic Machines

{basic_memory-0.15.2 → basic_memory-0.16.1}/README.md

@@ -7,6 +7,16 @@
 ![](https://badge.mcpx.dev?type=dev 'MCP Dev')
 [![smithery badge](https://smithery.ai/badge/@basicmachines-co/basic-memory)](https://smithery.ai/server/@basicmachines-co/basic-memory)
 
+## 🚀 Basic Memory Cloud is Live!
+
+- **Cross-device and multi-platform support is here.** Your knowledge graph now works on desktop, web, and mobile - seamlessly synced across all your AI tools (Claude, ChatGPT, Gemini, Claude Code, and Codex) 
+- **Early Supporter Pricing:** Early users get 25% off forever. 
+The open source project continues as always. Cloud just makes it work everywhere.
+
+[Sign up now →](https://basicmemory.com/beta)
+
+with a 7 day free trial
+
 # Basic Memory
 
 Basic Memory lets you build persistent knowledge through natural conversations with Large Language Models (LLMs) like
@@ -440,4 +450,4 @@ and submitting PRs.
  </picture>
 </a>
 
-Built with ♥️ by Basic Machines
+Built with ♥️ by Basic Machines

{basic_memory-0.15.2 → basic_memory-0.16.1}/docs/ai-assistant-guide-extended.md

@@ -77,25 +77,6 @@ SQLite Database (Index)
 3. Files are parsed and indexed in SQLite
 4. MCP server exposes indexed data to AI
 5. AI can query, traverse, and update knowledge graph
-
-### Version 0.15.0 Changes
-
-**Breaking Change: Stateless Architecture**
-- All MCP tools now require explicit `project` parameter
-- No implicit project context carried between calls
-- Exception: `default_project_mode` config option enables fallback
-
-**Three-Tier Project Resolution**:
-1. CLI constraint: `--project name` flag (highest priority)
-2. Explicit parameter: `project="name"` in tool calls
-3. Default mode: `default_project_mode=true` in config (fallback)
-
-**Why This Matters**:
-- More predictable behavior across sessions
-- Explicit project selection prevents errors
-- Multi-project workflows more reliable
-- Single-project users can enable default mode for convenience
-
 ---
 
 ## Project Management
@@ -576,7 +557,7 @@ Adopt GraphQL instead of REST for our API layer.
 """,
     folder="decisions",
     tags=["decision", "api", "graphql"],
-    entity_type="decision",
+    note_type="decision",
     project="main"
 )
 ```
@@ -613,7 +594,7 @@ await write_note(
 """,
     folder="meetings",
     tags=["meeting", "api", "team"],
-    entity_type="meeting",
+    note_type="meeting",
     project="main"
 )
 ```
@@ -665,7 +646,7 @@ Specification for user authentication system using JWT tokens.
 """,
     folder="specs",
     tags=["spec", "auth", "security"],
-    entity_type="spec",
+    note_type="spec",
     project="main"
 )
 ```
@@ -1631,7 +1612,7 @@ await write_note(
 {related_entities}
 """,
     folder="decisions",
-    entity_type="decision",
+    note_type="decision",
     project="main"
 )
 ```
@@ -2706,14 +2687,14 @@ await write_note(
 
 ### Content Management
 
-**write_note(title, content, folder, tags, entity_type, project)**
+**write_note(title, content, folder, tags, note_type, project)**
 - Create or update markdown notes
 - Parameters:
   - `title` (required): Note title
   - `content` (required): Markdown content
   - `folder` (required): Destination folder
   - `tags` (optional): List of tags
-  - `entity_type` (optional): Entity type (note, person, meeting, etc.)
+  - `note_type` (optional): Type of note (stored in frontmatter). Can be "note", "person", "meeting", "guide", etc.
   - `project` (required unless default_project_mode): Target project
 - Returns: Created/updated entity with permalink
 - Example:
@@ -2723,7 +2704,7 @@ await write_note(
     content="# API Design\n...",
     folder="specs",
     tags=["api", "design"],
-    entity_type="spec",
+    note_type="spec",
     project="main"
 )
 ```