motte 0.1.0

Defensive mount and root workspace helper for terminal environments
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

# motte

Defensive mount and root workspace helper for terminal environments.

## Purpose

`motte` (from Old English *mot*, a mound or defensive hillock) provides
workspace root detection, mount point resolution, path ancestry walking,
and defensive boundary enforcement for building secure terminal environments.

## Features

- **WorkspaceRoot** — find project roots by marker file search
- **MountPoint** — represent and query filesystem mount boundaries
- **PathAncestry** — walk path components from leaf to root
- **DefensiveBoundary** — safe path resolution with traversal prevention
- **Zero dependencies**

## Install

```bash
cargo add motte
```

## Usage

```rust
use motte::{WorkspaceRoot, MountPoint, DefensiveBoundary};

// Find workspace root by marker files
let root_finder = WorkspaceRoot::rust_defaults();

// Check mount points
let mp = MountPoint::new("/tmp");
assert!(mp.contains("/tmp/project/file.txt"));

// Defensive boundary for safe path resolution
let boundary = DefensiveBoundary::new("/tmp/project");
let safe_path = boundary.resolve_safe("src/main.rs").unwrap();
assert!(safe_path.starts_with("/tmp/project"));
```

## License

MIT OR Apache-2.0