portable-contract-normalizer

To detect absolute host paths and machine-local assumptions in repository contracts, run a scan over a bounded repository root. The scan identifies environment-specific brittleness, stale references, and path leakage, then generates Markdown and JSON reports.

You can automatically fix portability bugs in validation artifacts using the scan_and_apply_safe_fixes mode. This applies mechanical normalizations to replace host-specific fixtures with portable placeholders, but requires explicit operator approval before applying fixes.

When scanning bounded codebases for portability defects, target absolute host paths, brittle worktrees, machine-local temp paths, stale contract references, and environment-specific assertions. These machine-specific cues break portability across different environments.

The contract normalizer requires no external dependencies to scan review packets. It operates on a bounded repository root and requires mandatory inputs including a target path and a defined policy to execute scans and generate review artifacts.

The best way to normalize environment-specific assertions in test suites is to scan the bounded repository and apply narrowly scoped mechanical normalizations. This process replaces machine-local fixtures with portable placeholders while enforcing explicit stop conditions.