splice 2.4.0

Span-safe refactoring kernel for 7 languages with Magellan code graph integration
Documentation
# Splice v2.4.0 Release Notes

**Release Date:** 2026-02-04

Splice v2.4.0 is a feature release that improves preview mode JSON output and updates documentation.

---

## What's Fixed

### Preview Mode JSON Output

The `splice patch --preview --json` command now returns structured JSON:

```json
{
  "status": "ok",
  "message": "Previewed patch 'foo' at bytes 0..29 (dry-run)",
  "data": {
    "symbol": "foo",
    "preview_report": {
      "file": "src/lib.rs",
      "line_start": 1,
      "line_end": 3,
      "lines_added": 3,
      "lines_removed": 3,
      "bytes_added": 31,
      "bytes_removed": 29
    },
    "files": [{"file": "src/lib.rs"}]
  }
}
```

**Fields:**
- `preview_report.file`: Path to the modified file
- `preview_report.line_start`: Starting line number (1-indexed)
- `preview_report.line_end`: Ending line number (1-indexed)
- `preview_report.lines_added`: Number of lines added
- `preview_report.lines_removed`: Number of lines removed
- `preview_report.bytes_added`: Number of bytes added
- `preview_report.bytes_removed`: Number of bytes removed

## Documentation Updates

- **README.md**: Reorganized with badges, toolset diagram, and clearer command reference
- **MANUAL.md**: Condensed from 1654 to 342 lines, added preview JSON examples
- **CHANGELOG.md**: Updated with v2.2.4 changes

## Installation

```bash
cargo install splice
```

Or build from source:

```bash
git clone https://github.com/oldnordic/splice
cd splice
cargo build --release
cp target/release/splice ~/.local/bin/
```

## Upgrade from v2.2.x

No breaking changes. Simply reinstall:

```bash
cargo install splice --force
```

## Full Changelog

See [CHANGELOG.md](CHANGELOG.md) for complete version history.