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.

来源