aprender 0.30.0

Next-generation ML framework in pure Rust — `cargo install aprender` for the `apr` CLI
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

<!-- PCU: examples-shell-safety-training | contract: contracts/apr-page-examples-shell-safety-training-v1.yaml -->
<!-- Example: cargo run -p aprender-core --example shell_safety_training -->
<!-- Status: enforced -->

# Shell Safety Classifier Training

Trains an MLP classifier to predict shell script safety using the
bashrs corpus (17,942 entries) merged with adversarial data (~8,000
entries for minority classes).

The model classifies scripts into 5 safety categories:

- **safe**: passes all checks (lint, deterministic, idempotent)
- **needs-quoting**: variable quoting issues
- **non-deterministic**: contains `$RANDOM`, `$$`, timestamps
- **non-idempotent**: missing `-p`/`-f` flags
- **unsafe**: security rule violations

## Prerequisites

```bash
# Export corpus + generate adversarial data
cd /path/to/bashrs
cargo run -- corpus export-dataset --format classification -o /tmp/corpus.jsonl
cargo run -- generate-adversarial --verify -o /tmp/adversarial.jsonl
{ cat /tmp/corpus.jsonl; echo; cat /tmp/adversarial.jsonl; } > /tmp/combined.jsonl
```

## Run

```bash
cargo run --example shell_safety_training -- /tmp/combined.jsonl
```

## Source

```rust,ignore
// Run this example:
//   cargo run --example shell_safety_training
//
// See the CLI reference and source code in crates/ for implementation details.
```