magellan 3.2.0

Deterministic codebase mapping tool for local development
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

// Platform detection and feature flags
//
// Windows support is opt-in and explicit. This avoids silent behavior changes,
// bug reports from unsupported paths, and keeps trust with existing users.

#[cfg(feature = "windows")]
pub const IS_WINDOWS: bool = true;

#[cfg(not(feature = "windows"))]
pub const IS_WINDOWS: bool = false;

#[cfg(feature = "unix")]
pub const IS_UNIX: bool = true;

#[cfg(not(feature = "unix"))]
pub const IS_UNIX: bool = false;

/// Warn users about Windows limitations on first run
pub fn check_platform_support() {
    if IS_WINDOWS {
        eprintln!("=== Windows Support Notice ===");
        eprintln!("Windows support is analysis-only:");
        eprintln!("  - File watching may have reduced performance");
        eprintln!("  - No signal handling (Ctrl+C behavior varies)");
        eprintln!("  - No background process management");
        eprintln!();
        eprintln!("For production use on Windows, consider:");
        eprintln!("  - Using WSL2 with native Linux builds");
        eprintln!("  - Manual reindex instead of watch mode");
        eprintln!("==================================");
    }
}

/// Check if watch mode is supported on this platform
pub fn watch_mode_supported() -> bool {
    if IS_WINDOWS {
        // File watching works but has limitations
        eprintln!("Warning: Watch mode on Windows may have reduced performance.");
        eprintln!("         Use manual reindex for large codebases.");
        true
    } else {
        true
    }
}