obsidian-vault-crud

What problem does it solve?

Safe and reliable disk I/O for Obsidian Vault notes, ensuring atomic writes, advisory locking, and lossless frontmatter handling to prevent data loss during concurrent edits.

Core Features & Use Cases

• Atomic write and staging via .agent-tmp with secure rename
• Advisory lock at vault root to coordinate access
• Conflict detection via mtime checks to avoid overwritten edits
• Lossless YAML frontmatter preservation using ruamel.yaml
• Use Case: Update a vault note without risking partial writes or data corruption in multi-process environments.

Quick Start

Use vault_ops.py to create or update a note; the operation will perform atomic writes, advisory locking, and lossless frontmatter handling.