README

A PHP library for parsing and applying AI friendly diffs. Inspired by Aider edit formats.

Features

• Parse and validate a diff
• Apply a parsed diff to original content

Supported diffs

• udiff

Installation

composer require freelyive/ai-diff

Usage

use FreelyGive\AiDiff\Format\Udiff;

$diff = (new Udiff())->parse($diff_from_ai);

// Handle new files.
if ($diff->from === NULL) {
  add_file(
    filename: $diff->to, 
    contents: $diff->chunks[0]->getAfter(),
  );
}
// Handle removed files.
elseif ($diff->to === NULL) {
  remove_file(
    filename: $diff->from,
  );
}
// Handle updating files.
else {
  update_file(
    filename: $diff->from,
    new_filename: $diff->to,
    content: $diff->applyTo($original_content),
  );
}