Skip to content

OpenSIN-Code/SIN-Code-IBD-Tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SIN-Code Intent-Based Diffing (IBD)

Semantic diffs that summarize architectural intent and risk — not just lines added and removed.

Python License: MIT

Part of the SIN-Code agent-engineering stack.

Why

A line-based diff tells you what text changed. It does not tell you that a function signature changed (and may break callers), that a decorator controlling auth was removed, or that a rename happened. IBD diffs the AST, classifies the change into an intent, and assigns a risk score an agent or reviewer can act on.

Features

  • AST-level diff (Python) comparing symbols, signatures, decorators, docstrings and bodies — not raw text.
  • Intent classification: api_change, refactor, feature, cleanup, …
  • Risk scoring with a weighted breakdown by change type.
  • Git review mode — analyze uncommitted working-tree changes in one command.
  • Rich terminal output and --json for machine consumption.

Quickstart

pip install -e .
ibd diff old.py new.py          # semantic diff of two files
ibd diff old.py new.py --json   # machine-readable
ibd review-git                  # review uncommitted changes in the repo

Example

╭───────────────── SIN-Code IBD ─────────────────╮
│ Risk: high (6.0)                                │
╰─────────────────────────────────────────────────╯
[HIGH] API signatures modified: 1 symbol(s)
    Changed function/method signatures may break callers. Review required.

Documentation

License

MIT — see LICENSE.

About

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

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages