unfault 0.8.0

Unfault — a cognitive context engine for thoughtful engineers
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

//! # Session Management
//!
//! This module handles the complete session lifecycle for code analysis:
//!
//! 1. **Workspace scanning** - Detect project type, languages, and frameworks
//! 2. **File collection** - Apply file hints/patterns to select files for analysis
//! 3. **Session execution** - Create session, run analysis, and wait for results
//!
//! ## Architecture
//!
//! The session module separates concerns from the API layer:
//! - `api/session.rs` - HTTP calls and request/response types
//! - `session/` - Business logic for workspace scanning and session orchestration
//!
//! ## Usage
//!
//! ```rust,ignore
//! use unfault::session::{WorkspaceScanner, FileCollector, SessionRunner};
//!
//! // 1. Scan workspace
//! let scanner = WorkspaceScanner::new(&workspace_path);
//! let workspace_info = scanner.scan()?;
//!
//! // 2. Create session and get file hints
//! let runner = SessionRunner::new(api_client, api_key);
//! let session = runner.create_session(&workspace_info).await?;
//!
//! // 3. Collect files based on hints
//! let collector = FileCollector::new(&workspace_path);
//! let files = collector.collect(&session.file_hints)?;
//!
//! // 4. Run analysis and wait for results
//! let results = runner.run_analysis(&session.session_id, &workspace_info, files).await?;
//! ```

// file_collector: Legacy module for server-side parsing, not needed in standalone mode
// pub mod file_collector;
pub mod graph_builder;
pub mod header_extractor;
pub mod ir_builder;
pub mod patch_applier;
pub mod semantics_cache;
pub mod workspace;
pub mod workspace_id;
pub mod workspace_settings;

pub use graph_builder::{build_local_graph, SerializableGraph};
pub use header_extractor::{FileHeader, HeaderExtractor, HeaderExtractorConfig};
pub use ir_builder::{build_ir, build_ir_cached, IrBuildResult};
pub use patch_applier::{PatchApplier, PatchStats};
pub use semantics_cache::{CacheStats, SemanticsCache};
pub use workspace::{
    DetectedFramework, ProgressCallback, ScanProgress, WorkspaceInfo, WorkspaceScanner,
};
pub use workspace_id::{
    compute_workspace_id, get_git_changed_files, get_git_remote, normalize_git_remote,
    MetaFileInfo, WorkspaceIdResult, WorkspaceIdSource,
};
pub use workspace_settings::{
    load_settings, LoadedSettings, RuleSettings, SettingsSource, WorkspaceSettings,
};