mechanical-refactor-verify

Make mechanical refactoring (file splits, function moves, module extractions, renames) machine-checkable instead of eyeballed. Reproduce a relocation commit byte-for-byte from faithful primitives, and split an extraction into a verifiable prepare + move + postpare. Use when doing or reviewing such changes.

Install
npx skills add 'https://github.com/sgl-project/sglang/tree/main/.claude/skills/mechanical-refactor-verify'
Download bundle ↓
main · a9fb1c3Scanned 2026-09-17

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

scripts/tests/reproduction_utils/test_verify_and_run.py

scripts/tests/reproduction_utils/test_verify_and_run.pyBrowse 41 files
View on GitHub
← Back to SKILL.md
import subprocessimport sysfrom pathlib import Path import pytest sys.path.insert(0, str(Path(__file__).resolve().parents[2])) import mechanical_refactor_reproduction_utils as rrfrom mechanical_refactor_reproduction_utils import (    Repro,    _def_span,    _find_class,    _find_def,    _replace_span,    _slice_span,    dedent,    exec_command,    git_add_and_commit,    verify_mechanical_refactor,)from reproduction_testlib import _apply, _commit, _git, _write  # noqa: F401 # --- verify_mechanical_refactor ------------------------------------------------  def _silence_precommit(monkeypatch) -> None:    real = rr.exec_command     def fake(cmd: str, cwd=None, check=True):        if cmd.startswith("pre-commit"):            return ""        return real(cmd, cwd=cwd, check=check)     monkeypatch.setattr(rr, "exec_command", fake)  def test_reproduce_passes_when_transform_matches_target(    repo: Path, tmp_path: Path, monkeypatch, capsys) -> None:    """A transform that recreates the target tree reports PASS and does not exit."""    _write(repo, **{"src.py": "line1\nline2\nline3\n"})    base = _commit(repo, "base")    _write(repo, **{"src.py": None, "a.py": "line1\nline2\n", "b.py": "line3\n"})    target = _commit(repo, "split")     def transform(root: Path) -> None:        lines = (root / "src.py").read_text().splitlines(keepends=True)        (root / "a.py").write_text("".join(lines[0:2]))        (root / "b.py").write_text("".join(lines[2:3]))        (root / "src.py").unlink()        rr.git_add_and_commit("split", cwd=str(root))     monkeypatch.chdir(repo)    monkeypatch.setattr(rr.tempfile, "mkdtemp", lambda prefix="": str(tmp_path / "wt"))    _silence_precommit(monkeypatch)     verify_mechanical_refactor(base, target, transform)    assert "PASS" in capsys.readouterr().out  def test_reproduce_exits_when_transform_diverges(    repo: Path, tmp_path: Path, monkeypatch) -> None:    """A transform that produces a different tree fails with a non-zero exit."""    _write(repo, **{"src.py": "line1\nline2\nline3\n"})    base = _commit(repo, "base")    _write(repo, **{"src.py": None, "a.py": "line1\nline2\n", "b.py": "line3\n"})    target = _commit(repo, "split")     def wrong_transform(root: Path) -> None:        (root / "a.py").write_text("WRONG\n")        (root / "b.py").write_text("line3\n")        (root / "src.py").unlink()        rr.git_add_and_commit("split", cwd=str(root))     monkeypatch.chdir(repo)    monkeypatch.setattr(rr.tempfile, "mkdtemp", lambda prefix="": str(tmp_path / "wt"))    _silence_precommit(monkeypatch)     with pytest.raises(SystemExit):        verify_mechanical_refactor(base, target, wrong_transform)  def test_reproduce_creates_verify_branch_on_pass(    repo: Path, tmp_path: Path, monkeypatch, capsys) -> None:    """A PASS run leaves a verify-mechanical-<base[:8]> branch in the repo."""    _write(repo, **{"src.py": "line1\nline2\nline3\n"})    base = _commit(repo, "base")    _write(repo, **{"src.py": None, "a.py": "line1\nline2\n", "b.py": "line3\n"})    target = _commit(repo, "split")     def transform(root: Path) -> None:        lines = (root / "src.py").read_text().splitlines(keepends=True)        (root / "a.py").write_text("".join(lines[0:2]))        (root / "b.py").write_text("".join(lines[2:3]))        (root / "src.py").unlink()        rr.git_add_and_commit("split", cwd=str(root))     monkeypatch.chdir(repo)    monkeypatch.setattr(rr.tempfile, "mkdtemp", lambda prefix="": str(tmp_path / "wt"))    _silence_precommit(monkeypatch)     verify_mechanical_refactor(base, target, transform)    assert "PASS" in capsys.readouterr().out    branch = f"verify-mechanical-{base[:8]}"    assert _git(repo, "branch", "--list", branch).endswith(branch)  def _precommit_writes_file(monkeypatch, filename: str, contents: str) -> None:    real = rr.exec_command     def fake(cmd: str, cwd=None, check=True):        if cmd.startswith("pre-commit"):            (Path(cwd) / filename).write_text(contents)            return ""        return real(cmd, cwd=cwd, check=check)     monkeypatch.setattr(rr, "exec_command", fake)  def test_reproduce_commits_pre_commit_fixes_when_tree_left_dirty(    repo: Path, tmp_path: Path, monkeypatch, capsys) -> None:    """When pre-commit reformats and leaves the tree dirty, a 'pre-commit fixes' commit    is created on top of the transform commit."""    _write(repo, **{"src.py": "hello\n"})    base = _commit(repo, "base")    _write(repo, **{"src.py": "hello world\n", "formatted.py": "auto\n"})    target = _commit(repo, "edit")     def transform(root: Path) -> None:        (root / "src.py").write_text("hello world\n")        rr.git_add_and_commit("transform", cwd=str(root))     monkeypatch.chdir(repo)    monkeypatch.setattr(rr.tempfile, "mkdtemp", lambda prefix="": str(tmp_path / "wt"))    _precommit_writes_file(monkeypatch, "formatted.py", "auto\n")     verify_mechanical_refactor(base, target, transform)    assert "PASS" in capsys.readouterr().out    branch = f"verify-mechanical-{base[:8]}"    subjects = _git(repo, "log", "--format=%s", "-2", branch).splitlines()    assert subjects == ["pre-commit fixes", "transform"]  # --- Repro.run end-to-end ------------------------------------------------------  def test_repro_run_passes_on_a_faithful_call_site_lowering(    repo: Path, monkeypatch, capsys) -> None:    """End-to-end: a lowering reproduces the commit byte-for-byte (pre-commit stubbed)."""    _write(repo, **{"c.py": "r = Old.foo(self.n, 5)\n"})    base = _commit(repo, "base")    _write(repo, **{"c.py": "r = self.n.foo(5)\n"})    target = _commit(repo, "lower the call site")    monkeypatch.chdir(repo)    _silence_precommit(monkeypatch)     diff = Repro(base, target).lower_call_sites("foo", "Old", paths=["c.py"]).run()    assert diff == ""    assert "PASS" in capsys.readouterr().out  def test_repro_run_reports_residual_when_a_change_is_bundled(    repo: Path, monkeypatch, capsys) -> None:    """A bundled non-relocation change surfaces as a non-empty residual diff."""    _write(repo, **{"c.py": "r = Old.foo(self.n, 5)\nUNRELATED = 1\n"})    base = _commit(repo, "base")    _write(repo, **{"c.py": "r = self.n.foo(5)\nUNRELATED = 2\n"})    target = _commit(repo, "lower the call AND change a constant")    monkeypatch.chdir(repo)    _silence_precommit(monkeypatch)     diff = Repro(base, target).lower_call_sites("foo", "Old", paths=["c.py"]).run()    assert "UNRELATED" in diff    assert "RESIDUAL" in capsys.readouterr().out