sapphire-framework

Sapphire Framework is a Rust library for building applications that manage local file-based workspaces. It provides document indexing, full-text search, vector search, and synchronization capabilities for markdown, JSON, JSONL, and other text formats. Workspaces are identified by a marker directory (e.g., .my-app) with stable UUIDs derived from the workspace path. The framework uses redb for storage and tantivy for full-text indexing by default, with on-device embedding via FastEmbed. Configuration occurs through TOML files in the workspace directory or environment variables. The indexer processes files using format-specific chunking: paragraphs for markdown/text, per-element for JSON, and per-line for JSONL. Local file operations automatically update the index, while concurrent editing is managed through a central remote server (planned feature). Git version control requires manual handling rather than automatic synchronization.