Post-Migration Cleanup

Handles frontend/caller migration from legacy Pages Router to v2 App Router routes. This is Phase 13+ work — all v2 API routes must already exist before running this workflow.

Scope: Frontend callers, mutation hooks, legacy helpers, and legacy types ONLY. No API route creation (the recollect-api-migrator agent handles that).

Per-Route Workflow

Execute these steps in order for each route being cleaned up. Each step prevents a specific class of dead code or broken references.

1. Update the Mutation Hook

Import types from the v2 route file instead of apiTypes.ts. Point postApi to the v2 URL.

// Before
import { type LegacyPayload } from "@/types/apiTypes";
postApi<LegacyResponse>("/api/old/path", payload);