ryo-mutations 0.1.0

[experimental] Code transformation primitives for Rust source code
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
62
63
64
65
66
67
68
69
70
71

# ryo-mutations

[![crates.io](https://img.shields.io/crates/v/ryo-mutations.svg)](https://crates.io/crates/ryo-mutations)
[![docs.rs](https://docs.rs/ryo-mutations/badge.svg)](https://docs.rs/ryo-mutations)
[![License: MIT OR Apache-2.0](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg)](#license)

> **Status:** experimental. APIs may change in v0.x.
> Part of the [ryo](https://github.com/ynishi/ryo-rs) workspace —
> AST-centric Rust programming for AI agents.

Code transformation primitives for Rust source. Unified `Mutation` trait
with validation, serialization, and parallel-execution support. Mutations are
organised into modules by intent: `basic` (add / remove / rename / visibility),
`refactor` (extract / inline / split / merge), `idiom` (`unwrap` → `?`,
loops → iterators, `Default`), `clippy`, `analyzer` (rust-analyzer LSP),
and `debugger`.

## Install

```sh
cargo add ryo-mutations
```

## Quickstart

```rust,ignore
use ryo_mutations::{ValidationStrategy, ValidationLevel, basic::AddField};

let mutation = AddField {
    target: "Config".into(),
    field_name: "timeout".into(),
    field_type: "u64".into(),
    // ...
};

// Validate before applying
let result = mutation.validate(&pure_file, ValidationStrategy::BlockConflicts);
if result.max_severity() >= ValidationLevel::Conflict {
    // refuse to apply
}
```

## API Summary

| Module | Purpose |
|---|---|
| `basic::*` | Fundamental AST edits (add / remove / rename / visibility) |
| `refactor::*` | Structural transformations |
| `idiom::*` | Idiomatic Rust pattern rewrites |
| `clippy::*` | Clippy lint integration |
| `analyzer::*` | rust-analyzer LSP integration |
| `debugger::*` | Debug logging utilities |
| `serializable::*` | Mutation serialization for plan files |

| Validation type | Use case |
|---|---|
| `AllowAll` | FactionBoard / speculative execution |
| `BlockFatalOnly` | Speculative execution (block only fatal) |
| `BlockConflicts` | Sequential execution |
| `Strict` | Debugging (block all issues) |

## Status

**Experimental.** The Writer side of ryo is still evolving — APIs in this
crate may change between v0.x releases. Production-quality stability is
deferred to v1.0.

## License

Licensed under either of [Apache-2.0](https://github.com/ynishi/ryo-rs/blob/main/LICENSE-APACHE)
or [MIT](https://github.com/ynishi/ryo-rs/blob/main/LICENSE-MIT) at your option.