Skip to content

Improve Keystone migration agent with examples and targeted update guidance#342

Merged
borisno2 merged 2 commits intomainfrom
claude/improve-keystone-migration-agent-DhnJG
Feb 22, 2026
Merged

Improve Keystone migration agent with examples and targeted update guidance#342
borisno2 merged 2 commits intomainfrom
claude/improve-keystone-migration-agent-DhnJG

Conversation

@borisno2
Copy link
Member

  • Rewrite migration-assistant.md with side-by-side Keystone vs OpenSaaS
    examples covering config structure, imports, access control, hooks, auth,
    and M2M join tables; replace encouraging-but-vague tone with concrete diffs
  • Add 'Update, Don't Rewrite' section making explicit that lists/fields/hooks
    copy over unchanged; prohibit suggesting migration is a big job
  • Add Keystone fast-path in migration-wizard.ts (3 questions instead of 9+):
    db provider, auth presence, auth methods
  • Add generateKeystoneMigrationGuide() in migration-generator.ts that produces
    a diff-style step-by-step guide (imports, db adapter, session references,
    auth) rather than regenerating list definitions the user already has
  • Surface M2M join table naming automatically when relationships are detected

https://claude.ai/code/session_0197VyPUN3y4KSaVkyMnfpLk

…idance

- Rewrite migration-assistant.md with side-by-side Keystone vs OpenSaaS
  examples covering config structure, imports, access control, hooks, auth,
  and M2M join tables; replace encouraging-but-vague tone with concrete diffs
- Add 'Update, Don't Rewrite' section making explicit that lists/fields/hooks
  copy over unchanged; prohibit suggesting migration is a big job
- Add Keystone fast-path in migration-wizard.ts (3 questions instead of 9+):
  db provider, auth presence, auth methods
- Add generateKeystoneMigrationGuide() in migration-generator.ts that produces
  a diff-style step-by-step guide (imports, db adapter, session references,
  auth) rather than regenerating list definitions the user already has
- Surface M2M join table naming automatically when relationships are detected

https://claude.ai/code/session_0197VyPUN3y4KSaVkyMnfpLk
@changeset-bot
Copy link

changeset-bot bot commented Feb 22, 2026

🦋 Changeset detected

Latest commit: cbee386

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 9 packages
Name Type
@opensaas/stack-cli Minor
@opensaas/stack-auth Minor
@opensaas/stack-core Minor
@opensaas/stack-rag Minor
@opensaas/stack-storage-s3 Minor
@opensaas/stack-storage-vercel Minor
@opensaas/stack-storage Minor
@opensaas/stack-tiptap Minor
@opensaas/stack-ui Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
Copy link

vercel bot commented Feb 22, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
stack-docs Ready Ready Preview, Comment Feb 22, 2026 3:21am

The wizard completion output was refactored to distinguish Keystone
migrations (migration guide) from Prisma/Next.js migrations (generated
config). The heading changed from '# ✅ Migration Complete!' to
'# Generated opensaas.config.ts', and the dependencies section from
'## Install Dependencies' to '## Dependencies'.

Update the test assertions to match the new output format.

https://claude.ai/code/session_0197VyPUN3y4KSaVkyMnfpLk
@github-actions
Copy link
Contributor

Coverage Report for Core Package Coverage (./packages/core)

Status Category Percentage Covered / Total
🔵 Lines 86.17% 455 / 528
🔵 Statements 85.45% 464 / 543
🔵 Functions 97.22% 70 / 72
🔵 Branches 73.86% 325 / 440
File CoverageNo changed files found.
Generated in workflow #951 for commit cbee386 by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

Coverage Report for UI Package Coverage (./packages/ui)

Status Category Percentage Covered / Total
🔵 Lines 76.03% 92 / 121
🔵 Statements 75.39% 95 / 126
🔵 Functions 75.6% 31 / 41
🔵 Branches 65.78% 75 / 114
File CoverageNo changed files found.
Generated in workflow #951 for commit cbee386 by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

Coverage Report for CLI Package Coverage (./packages/cli)

Status Category Percentage Covered / Total
🔵 Lines 75.65% 1147 / 1516
🔵 Statements 75.31% 1190 / 1580
🔵 Functions 80.41% 156 / 194
🔵 Branches 65% 522 / 803
File Coverage
File Stmts Branches Functions Lines Uncovered Lines
Changed Files
packages/cli/src/mcp/lib/wizards/migration-wizard.ts 91.35% 80.55% 92.1% 91.78% 221, 234-270, 403, 449, 466-478, 499, 554, 597
packages/cli/src/migration/generators/migration-generator.ts 46.75% 35.4% 35.71% 48.21% 42, 52, 99-102, 125-358, 385-396, 400-407, 424-601
Generated in workflow #951 for commit cbee386 by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

Coverage Report for Auth Package Coverage (./packages/auth)

Status Category Percentage Covered / Total
🔵 Lines 64.49% 89 / 138
🔵 Statements 61.03% 94 / 154
🔵 Functions 74.46% 35 / 47
🔵 Branches 62.79% 54 / 86
File CoverageNo changed files found.
Generated in workflow #951 for commit cbee386 by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

Coverage Report for Storage Package Coverage (./packages/storage)

Status Category Percentage Covered / Total
🔵 Lines 42.44% 73 / 172
🔵 Statements 42.77% 74 / 173
🔵 Functions 42.85% 15 / 35
🔵 Branches 40.13% 61 / 152
File CoverageNo changed files found.
Generated in workflow #951 for commit cbee386 by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

Coverage Report for RAG Package Coverage (./packages/rag)

Status Category Percentage Covered / Total
🔵 Lines 47.97% 355 / 740
🔵 Statements 48.14% 377 / 783
🔵 Functions 54.26% 70 / 129
🔵 Branches 42.55% 180 / 423
File CoverageNo changed files found.
Generated in workflow #951 for commit cbee386 by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

Coverage Report for Storage S3 Package Coverage (./packages/storage-s3)

Status Category Percentage Covered / Total
🔵 Lines 100% 40 / 40
🔵 Statements 100% 40 / 40
🔵 Functions 100% 9 / 9
🔵 Branches 100% 19 / 19
File CoverageNo changed files found.
Generated in workflow #951 for commit cbee386 by the Vitest Coverage Report Action

@github-actions
Copy link
Contributor

Coverage Report for Storage Vercel Package Coverage (./packages/storage-vercel)

Status Category Percentage Covered / Total
🔵 Lines 100% 38 / 38
🔵 Statements 100% 38 / 38
🔵 Functions 100% 8 / 8
🔵 Branches 100% 22 / 22
File CoverageNo changed files found.
Generated in workflow #951 for commit cbee386 by the Vitest Coverage Report Action

@borisno2 borisno2 merged commit 94b0df6 into main Feb 22, 2026
6 checks passed
@github-actions github-actions bot mentioned this pull request Feb 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants