Safe sync and CI
Generated files should never feel mysterious. Preview mode shows the exact file diff and config patches before NEPOPSX writes anything, while exit-on-changes turns that same check into a CI drift gate.
Preview a local sync
Preview prints colored unified diffs for created and updated files, plus incoming config patches. It makes no filesystem changes.
Preview team-approved state
Add --remote to fetch the canonical workspace config and approved learnings before calculating the diff. Specify a workspace when the repository cannot infer one unambiguously.
Detect drift in CI
--exit-on-changes exits non-zero when preview finds a pending file or config change. A zero exit means the checked-in generated state matches the current model.
Protect hand edits
Normal sync protects hand-edited generated files by backing them up before replacement. Use --force only when you intentionally want to overwrite without that backup.
--dry-run remains a deprecated alias for --preview. Prefer --preview in new scripts.