[suiramdev]

Summary

bankConnection.exchangeCode now starts the new connection's first sync right after saving it, through startAccountSync, extracted unchanged from budget.syncAccounts. Look first at packages/api/src/routers/bank-connection.ts and the shell guard in use-account-sync.ts.

Motivation

• During onboarding no sync ran until the user reached Home, so the first page loaded data on demand.
• Home and Budget now show data already imported, or a sync in progress.

Drawbacks

• One sync runs at a time: a bank linked during a running sync waits for the next one (documented).
• A failure to start the sync is only logged; the connection still succeeds.

Prior art

• Keeping the client-side trigger was rejected: it only fires once onboarding completes.

Notes

• No visual change.
• No new test: exchangeCode has no injection seam for provider, prisma, signed state and nonce.
• Docs updated: use/bank-connections, reference/procedures, index.
• exchangeCode returns a new syncStartedAt field; no migration.