migrate-imports

Find and replace all KeystoneJS import paths with their OpenSaaS Stack equivalents across the project described below. This is a mechanical find-and-replace across every TypeScript/JavaScript file.

$ARGUMENTS

Import Mapping

Keystone import (remove/replace)	OpenSaaS import
@keystone-6/core	@opensaas/stack-core
@keystone-6/core/fields	@opensaas/stack-core/fields
@keystone-6/auth	@opensaas/stack-auth (see note)
@keystone-6/fields-document	@opensaas/stack-tiptap/fields (see note)
.keystone/types or '.keystone/types'	@opensaas/stack-core
@keystone-6/core/session	Remove entirely (handled by authPlugin)

Note on @keystone-6/auth: This is NOT a pure find-and-replace. Keystone's createAuth/withAuth have no equivalent export on @opensaas/stack-auth — replace the whole pattern with authPlugin(...) in the config's plugins array. (The stack's createAuth on @opensaas/stack-auth/server is a different function — it builds the Better-auth server instance for lib/auth.ts.)

Note on @keystone-6/fields-document: Replace with @opensaas/stack-tiptap/fields and change document() → richText(). If document field migration is complex, note it for the user and leave a // TODO: migrate document field comment.

Note on .keystone/types: Common imports to update:

// Before
import type { Session } from '.keystone/types'
import type { KeystoneContext } from '.keystone/types'
import type { Lists } from '.keystone/types'

// After
import type { AccessControl } from '@opensaas/stack-core'
import type { Lists } from '@/.opensaas/lists'
// KeystoneContext is no longer needed — use the context from getContext().
// Keystone's `Lists` types have a direct successor: the generated
// `@/.opensaas/lists` namespace, used as list<Lists.Post.TypeInfo>({ ... }).

Config File Rename

If the project has keystone.ts or keystone.config.ts, it should be renamed to opensaas.config.ts. Check if it has already been renamed before doing so.

Steps

1. Use Glob to find all .ts and .tsx files in the project (exclude node_modules, .next, dist)
2. Use Grep to identify which files contain @keystone-6 or .keystone/types imports
3. For each affected file: a. Read the file b. Apply the import replacements from the table above c. For .keystone/types imports, update the specific type names (Session → AccessControl, etc.) d. Edit the file with the changes
4. Check if keystone.ts or keystone.config.ts exists and rename to opensaas.config.ts if needed (and if not already done)
5. Report: list every file changed and what was replaced