Skip to content

Repository files navigation

IBD — Intent-Based Diffing

IBD is a semantic code diff tool that understands what changed structurally, not just which lines were modified. It parses source code into ASTs, compares them recursively, and reports high-level changes like "function added", "parameter removed", "class renamed", or "import changed". This makes it ideal for code review, changelog generation, and refactoring verification.

SOTA Status

  • Tests: 5 passing (pytest tests/ -q, ~0.2s)
  • CI: ci (placeholder — wire up GitHub Actions)
  • Maturity tier: 1 / 3 (MVP — v0.1.0)
  • Last commit: 2026-06-06

Quick Start

pip install -e .
ibd diff before.py after.py

CLI

ibd diff <before.py> <after.py>          # text report to stdout
ibd diff <before.py> <after.py> --json   # JSON report (machine-readable)

Exit code: 0 = no structural changes, non-zero = changes detected (suitable for CI).

Integration

This tool is exposed in the unified sin code hub:

sin code ibd diff a.py b.py       # alias of: ibd diff a.py b.py

See AGENTS.md for boundaries, key files, and verification steps.

License

MIT

About

Intent-Based Diffing (semantic + AST) for AI coding agents — extracted from SIN-Code-Bundle (issue #28)

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages