maproom 0.1.0

Semantic code search powered by embeddings and SQLite
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

//! Incremental indexing system.
//!
//! This module provides the infrastructure for incremental indexing, including:
//! - File content hashing with blake3
//! - In-memory hash cache for fast change detection
//! - Change detection logic
//! - File system watching with debouncing
//! - Ignore pattern filtering
//! - Multi-worktree support with event isolation
//! - Priority-based update queue with retry logic
//! - Incremental file processing with atomic updates
//! - Edge relationship maintenance
//!
//! # Path Handling Strategy
//!
//! The watch command deals with two path representations:
//! - **Absolute paths**: From file watcher (e.g., `/workspace/src/main.rs`)
//! - **Relative paths**: Stored in database (e.g., `src/main.rs`)
//!
//! **Critical Rule**: Always normalize to relative paths for database queries using
//! [`normalize_to_relpath()`](path_utils::normalize_to_relpath). Use absolute paths
//! only for filesystem operations (reading files, checking metadata).
//!
//! **Bug Fixed**: Previously, the watch command passed absolute paths to database
//! lookup functions that expected relative paths. This caused existing files to be
//! misclassified as NEW, resulting in "File not found" errors during re-indexing.
//! See `.crewchief/archive/projects/WATCHFIX_watch-change-detection-fix/planning/analysis.md`
//! for detailed root cause analysis.
//!
//! # Security Considerations
//!
//! - **Path traversal protection**: [`normalize_to_relpath()`](path_utils::normalize_to_relpath)
//!   rejects paths containing `..` components
//! - **File size limits**: Files larger than 10MB are skipped to prevent DoS
//! - **Symlink awareness**: Symlinks are logged but allowed (user responsibility)

pub mod cache;
pub mod detector;
pub mod edge_updater;
pub mod events;
pub mod git_poller;
pub mod git_state;
pub mod hash;
pub mod ignore;
pub mod multi_watcher;
pub mod path_utils;
pub mod processor;
pub mod queue;
pub mod task;
pub mod tree_sha_update;
pub mod watcher;
pub mod worktree_watcher;

pub use cache::HashCache;
pub use detector::{ChangeDetector, ChangeType};
pub use edge_updater::EdgeUpdater;
pub use events::{EventType, FileEvent, IndexingEvent, WorktreeId};
pub use git_poller::{GitPoller, GitPollerConfig, GitPollerError, GitPollerStats};
pub use git_state::{FileStatus, GitState, GitStateError};
pub use hash::{ContentHash, FileHasher};
pub use ignore::IgnorePatternMatcher;
pub use multi_watcher::MultiWatcher;
pub use path_utils::normalize_to_relpath;
pub use processor::IncrementalProcessor;
pub use queue::{QueueStats, UpdateQueue};
pub use task::{Priority, Trigger, UpdateTask};
pub use tree_sha_update::{incremental_update, remove_worktree_from_chunks};
pub use watcher::{FileWatcher, WatcherConfig, WatcherError};
pub use worktree_watcher::{WatcherStatus, WorktreeWatcher};