mechanical-refactor-verify

To verify a mechanical refactor, you validate a reproducible transform script against a target commit. This ensures PR changes from file splits or module extractions are captured by the script rather than a manual diff.

Auditable verification enforces using a reproducible transform script in the PR description. It validates automated diffs against a target commit to ensure changes are verifiable beyond a plain diff.

You create a transform function that operates in a git worktree using base and target commits. Invoking verify_mechanical_refactor gates the diffs to confirm the transform script reproduces the changes.

You need a transform script for PR review when handling file splits, function moves, or module extractions. It ensures the mechanical refactor is reproducible and verifiable against a target commit.

Yes, mechanical refactor verification integrates with pre-commit checks. The worktree-based validation triggers during the commit process to gate diffs and prevent regressions before merging.

Manual diffs fail verification because the process requires a reproducible transform script. Without a script operating on base and target commits in a worktree, the changes cannot be audited or validated.