gestura_core_explorer/lib.rs
1//! Workspace-bounded file-system exploration utilities for Gestura.
2//!
3//! `gestura-core-explorer` provides lightweight exploration helpers used by the
4//! agent pipeline and presentation layers to inspect a workspace safely.
5//!
6//! ## Responsibilities
7//!
8//! - directory listing with stable sorting and truncation reporting
9//! - root-relative path handling suitable for UI and agent consumption
10//! - workspace-bounded resolution to avoid accidental path escape
11//! - related status helpers such as git-aware inspection surfaces
12//!
13//! ## Safety model
14//!
15//! Explorer operations are designed around a workspace root. Canonicalization
16//! and root-bounded resolution help ensure that symlinks or path traversal do
17//! not silently escape the intended workspace. Entries that resolve outside the
18//! workspace are omitted rather than exposed.
19//!
20//! ## Stable import paths
21//!
22//! Most code should import through `gestura_core::explorer::*`.
23
24mod explorer;
25
26pub use explorer::*;