Migration Diary: Freeze a Public‑Surface Snapshot Before You Leave a Paid Coding Agent

Описание и применение

Сохраняйте снимок публичной поверхности репозитория перед переходом на бесплатный хост, чтобы избежать неожиданных изменений, вносимых платным агентом.

Задача

When a paid coding agent seat expires, the public surface of a repository can change without notice, breaking downstream callers that rely on stable names such as CLI flags, HTTP paths, and Python exports.

Результат

The repository now has a frozen, version‑controlled public surface that survives the paid agent’s expiration, preventing silent breaking changes on a free host.

Рабочий процесс

• Walk the last merged agent patches and list every public name those patches changed.
• Run the extractor on the current default branch and commit the resulting JSON snapshot.
• Install a local apply gate that reads unified diffs before any host writes files.
• Replay a known‑good patch and a known‑bad rename to validate the gate.
• Move generation to the free host only after the gate has failed a planted rename.
• File a leftovers note for vendor‑side refactors that were not extracted.

Доказательства

A snapshot of CLI flags, HTTP paths, and Python exports gives you a meter that survives the vendor tab.

Источник

Run the extractor on the current default branch and commit the JSON snapshot beside the code.

Источник