studioxvii Compare Maps
Compare normalized maps while preserving evidence from both sides.
Follow ../../references/interaction-contract.md.
Process
- Normalize both inputs without changing unresolved engineering values.
- Run
python3 <skill-dir>/scripts/run.py --before <old.json> --after <new.json> --output <diff.json>. - Report added, removed, moved, changed, and unresolved points.
- Treat route, unit, area, or protocol-offset changes as moves when logical identity remains stable.
- Highlight address, datatype, width, access, scale, byte-order, enum, and evidence changes.
Output files
diff.json- Open this comparison. It lists added, removed, moved, changed, and unresolved points without changing either input map.
Completion requires every point from both inputs to have a disposition.
Stop
- Stop on schema mismatch or unresolved composite identity.
- Do not treat numeric address alone as identity.
- Do not collapse points from different routes, areas, or unit identifiers.
Handoff
- The new source still needs review: suggest
review-map. - The requested change is only address notation: suggest
remap-addresses.
Use composite identity. Numeric address alone is not an identity.