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_cli/test_report.py

scripts/tests/reproduction_cli/test_report.pyBrowse 41 files
View on GitHub
← Back to SKILL.md
import sysfrom pathlib import Path sys.path.insert(0, str(Path(__file__).resolve().parents[2])) from cli_testlib import _chain, _write_stub_prooffrom mechanical_refactor_reproduction_cli import main, render_report, verify_chain  def _mixed_chain_result(repo: Path, tmp_path: Path):    proof = tmp_path / "proof"    base, shas = _chain(        repo,        [            "mechanical_provable: move foo",            "non_mechanical_provable: rework bar",            "mechanical_provable: move baz",        ],    )    _write_stub_proof(proof, shas[0])    result = verify_chain(base=base, branch="chain", proof=proof, repo_root=str(repo))    return proof, base, shas, result  def test_report_has_header_table_row_per_commit_and_chain_verdict(    repo: Path, tmp_path: Path) -> None:    """The report carries base/branch/proof, one table row per commit, and the verdict."""    proof, base, shas, result = _mixed_chain_result(repo, tmp_path)    report = render_report(result)     assert "# Mechanical refactor chain report" in report    assert f"`{base[:12]}`" in report    assert "chain verdict: **FAIL**" in report    assert "3 total — 2 mechanical_provable, 1 non_mechanical_provable" in report    for sha in shas:        assert f"`{sha[:9]}`" in report    assert "| mechanical_provable | PASS |" in report    assert "| non_mechanical_provable | HUMAN_REVIEW |" in report    assert "| mechanical_provable | MISSING_PROOF |" in report  def test_report_lists_failure_details_for_each_non_ok_commit(    repo: Path, tmp_path: Path) -> None:    """Every non-ok commit gets a failure-details section with its explanation."""    proof, base, shas, result = _mixed_chain_result(repo, tmp_path)    report = render_report(result)     assert "## Failure details" in report    assert f"### `{shas[2][:9]}` — MISSING_PROOF" in report    assert "no proof script found" in report  def test_passing_report_has_no_failure_details_section(    repo: Path, tmp_path: Path) -> None:    """A fully verified chain renders a PASS report without a failure section."""    proof = tmp_path / "proof"    base, shas = _chain(repo, ["mechanical_provable: move foo"])    _write_stub_proof(proof, shas[0])    result = verify_chain(base=base, branch="chain", proof=proof, repo_root=str(repo))    report = render_report(result)     assert "chain verdict: **PASS**" in report    assert "proofs: 1/1 PASS" in report    assert "## Failure details" not in report  def test_main_writes_the_report_into_the_proof_folder_by_default(    repo: Path, tmp_path: Path, capsys) -> None:    """main prints the report and writes <proof>/chain_report.md (or --report PATH)."""    proof = tmp_path / "proof"    base, shas = _chain(repo, ["mechanical_provable: move foo"])    _write_stub_proof(proof, shas[0])    args = [        "--base",        base,        "--branch",        "chain",        "--proof",        str(proof),        "--repo-root",        str(repo),    ]     assert main(args) == 0    default_report = proof / "chain_report.md"    assert "chain verdict: **PASS**" in default_report.read_text()    assert "chain verdict: **PASS**" in capsys.readouterr().out     custom = tmp_path / "custom_report.md"    assert main([*args, "--report", str(custom)]) == 0    assert "chain verdict: **PASS**" in custom.read_text()