diff --git a/.vitepress/theme/components/MigrationTool.vue b/.vitepress/theme/components/MigrationTool.vue
new file mode 100644
index 0000000000..f5213399df
--- /dev/null
+++ b/.vitepress/theme/components/MigrationTool.vue
@@ -0,0 +1,753 @@
+<template>
+  <div class="migration-tool-container">
+      <section class="version-selector">
+        <div class="selector-group">
+          <div class="selector-item">
+            <label for="sourceVersion">Source Version</label>
+            <select v-model="sourceVersion" id="sourceVersion" class="version-dropdown">
+              <option value="">Select version...</option>
+              <option v-for="version in versions" :key="version" :value="version">
+                {{ version }}
+              </option>
+            </select>
+          </div>
+          <div class="arrow">→</div>
+          <div class="selector-item">
+            <label for="targetVersion">Target Version</label>
+            <select v-model="targetVersion" id="targetVersion" class="version-dropdown">
+              <option value="">Select version...</option>
+              <option v-for="version in versions" :key="version" :value="version">
+                {{ version }}
+              </option>
+            </select>
+          </div>
+        </div>
+        <button @click="showMigrations" class="btn-primary">Show Migration Steps</button>
+      </section>
+
+      <section v-show="resultsVisible" class="results">
+        <div class="results-header">
+          <div class="header-left">
+            <h3>Migration Steps</h3>
+            <div class="search-container">
+              <input 
+                v-model="searchQuery" 
+                type="text" 
+                class="search-input" 
+                placeholder="Search migrations..."
+                @input="onSearchInput"
+              >
+              <button 
+                v-show="searchQuery" 
+                @click="clearSearch" 
+                class="clear-search"
+              >×</button>
+            </div>
+          </div>
+          <div class="header-right">
+            <div class="filter-buttons">
+              <button 
+                v-for="filter in filters" 
+                :key="filter.value"
+                :class="['filter-btn', { active: activeFilter === filter.value }]"
+                @click="setFilter(filter.value)"
+              >
+                {{ filter.label }}
+              </button>
+              <button @click="exportToMarkdown" class="btn-export">Export Checklist</button>
+            </div>
+          </div>
+        </div>
+        <div v-show="visibleMigrations.length > 0" class="migration-list">
+          <div 
+            v-for="migration in visibleMigrations" 
+            :key="migration.id"
+            :class="['migration-card', `severity-${migration.severity}`]"
+            :data-category="migration.category"
+            :data-id="migration.id"
+          >
+            <div class="card-header">
+              <h4>{{ migration.title }}</h4>
+              <div class="badges">
+                <span v-if="migration.severity === 'high'" class="badge severity-high">High Priority</span>
+                <span v-if="migration.severity === 'medium'" class="badge severity-medium">Medium Priority</span>
+                <span v-if="migration.severity === 'low'" class="badge severity-low">Low Priority</span>
+                <span class="badge category-badge">{{ migration.category }}</span>
+                <span v-if="migration.actionRequired" class="badge action-required">Action Required</span>
+              </div>
+            </div>
+            <div class="version-info">
+              <span class="version-tag">{{ migration.sourceVersion }}</span>
+              <span class="arrow">→</span>
+              <span class="version-tag">{{ migration.targetVersion }}</span>
+            </div>
+            <p class="description">{{ migration.description }}</p>
+            <div v-if="migration.steps && migration.steps.length > 0" class="steps">
+              <h5>Migration Steps:</h5>
+              <ol>
+                <li v-for="(step, index) in migration.steps" :key="index">{{ step }}</li>
+              </ol>
+            </div>
+            <div v-if="migration.references && migration.references.length > 0" class="references">
+              <h5>References:</h5>
+              <ul>
+                <li v-for="(ref, index) in migration.references" :key="index">
+                  <a :href="ref" target="_blank">{{ ref }}</a>
+                </li>
+              </ul>
+            </div>
+          </div>
+        </div>
+        <div v-show="currentMigrations.length > 0 && visibleMigrations.length === 0" class="no-results">
+          <p>No migrations found matching your search.</p>
+        </div>
+        <div v-show="currentMigrations.length === 0" class="no-results">
+          <p>No migration steps found for the selected versions.</p>
+        </div>
+      </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+// @ts-ignore
+import { ref, computed } from 'vue'
+// @ts-ignore
+import migrationDataJson from '../../../tools/assets/migration-data.json'
+
+// Type definitions
+interface Migration {
+  id: string
+  title: string
+  sourceVersion: string
+  targetVersion: string
+  category: string
+  severity: string
+  actionRequired: boolean
+  description: string
+  steps: string[]
+  references: string[]
+}
+
+// Reactive state
+const sourceVersion = ref('')
+const targetVersion = ref('')
+const currentMigrations = ref<Migration[]>([])
+const resultsVisible = ref(false)
+const searchQuery = ref('')
+const activeFilter = ref('all')
+
+// Data from imported JSON
+// @ts-ignore
+const versions: string[] = migrationDataJson.versions
+// @ts-ignore
+const allMigrations: Migration[] = migrationDataJson.migrations
+
+// Filter options
+const filters = [
+  { value: 'all', label: 'All' },
+  { value: 'Breaking Change', label: 'Breaking Changes' },
+  { value: 'Requirement', label: 'Requirements' },
+  { value: 'Enhancement', label: 'Enhancements' }
+]
+
+// Computed property for visible migrations after filtering
+const visibleMigrations = computed(() => {
+  // @ts-ignore
+  return currentMigrations.value.filter(migration => {
+    // Category filter
+    const matchesCategory = activeFilter.value === 'all' || migration.category === activeFilter.value
+    
+    // Search filter
+    const searchTerm = searchQuery.value.toLowerCase()
+    const matchesSearch = !searchTerm || (
+      migration.title.toLowerCase().includes(searchTerm) ||
+      migration.description.toLowerCase().includes(searchTerm) ||
+      migration.category.toLowerCase().includes(searchTerm)
+    )
+    
+    return matchesCategory && matchesSearch
+  })
+})
+
+// Methods
+function showMigrations() {
+  if (!sourceVersion.value || !targetVersion.value) {
+    alert('Please select both source and target versions.')
+    return
+  }
+  
+  if (parseFloat(sourceVersion.value) >= parseFloat(targetVersion.value)) {
+    alert('Target version must be higher than source version.')
+    return
+  }
+  
+  const sourceNum = parseFloat(sourceVersion.value)
+  const targetNum = parseFloat(targetVersion.value)
+  
+  // @ts-ignore
+  currentMigrations.value = allMigrations.filter(migration => {
+    const migrationSource = parseFloat(migration.sourceVersion)
+    const migrationTarget = parseFloat(migration.targetVersion)
+    
+    return migrationSource >= sourceNum && migrationTarget <= targetNum
+  })
+  
+  resultsVisible.value = true
+  
+  // Scroll to results with a small delay to ensure rendering
+  setTimeout(() => {
+    const resultsSection = document.querySelector('.results')
+    if (resultsSection) {
+      resultsSection.scrollIntoView({ behavior: 'smooth' })
+    }
+  }, 100)
+}
+
+function setFilter(filterValue: string) {
+  activeFilter.value = filterValue
+}
+
+function onSearchInput() {
+  // Search is handled by computed property
+}
+
+function clearSearch() {
+  searchQuery.value = ''
+}
+
+function exportToMarkdown() {
+  if (!sourceVersion.value || !targetVersion.value || currentMigrations.value.length === 0) {
+    alert('Please select versions and show migrations first.')
+    return
+  }
+  
+  let markdown = `# CAP Migration Checklist\n\n`
+  markdown += `## Migration: ${sourceVersion.value} → ${targetVersion.value}\n\n`
+  markdown += `Generated: ${new Date().toLocaleDateString()}\n\n`
+  markdown += `---\n\n`
+  
+  const categories = ['Breaking Change', 'Requirement', 'Enhancement']
+  
+  categories.forEach(category => {
+    // @ts-ignore
+    const migrations = currentMigrations.value.filter(m => m.category === category)
+    
+    if (migrations.length > 0) {
+      markdown += `## ${category}s\n\n`
+      
+      migrations.forEach(migration => {
+        markdown += `### ${migration.title}\n\n`
+        markdown += `**Versions:** ${migration.sourceVersion} → ${migration.targetVersion}  \n`
+        markdown += `**Severity:** ${migration.severity}  \n`
+        markdown += `**Action Required:** ${migration.actionRequired ? 'Yes' : 'No'}  \n\n`
+        markdown += `${migration.description}\n\n`
+        
+        if (migration.steps && migration.steps.length > 0) {
+          markdown += `**Migration Steps:**\n\n`
+          migration.steps.forEach((step: string, index: number) => {
+            markdown += `${index + 1}. ${step}\n`
+          })
+          markdown += `\n`
+        }
+        
+        if (migration.references && migration.references.length > 0) {
+          markdown += `**References:**\n\n`
+          migration.references.forEach((ref: string) => {
+            markdown += `- ${ref}\n`
+          })
+          markdown += `\n`
+        }
+        
+        markdown += `---\n\n`
+      })
+    }
+  })
+  
+  markdown += `## Summary\n\n`
+  markdown += `- Total migrations: ${currentMigrations.value.length}\n`
+  
+  downloadMarkdown(markdown, `CAP-Migration-${sourceVersion.value}-to-${targetVersion.value}.md`)
+}
+
+function downloadMarkdown(content: string, filename: string) {
+  const blob = new Blob([content], { type: 'text/markdown' })
+  const url = URL.createObjectURL(blob)
+  const a = document.createElement('a')
+  a.href = url
+  a.download = filename
+  document.body.appendChild(a)
+  a.click()
+  document.body.removeChild(a)
+  URL.revokeObjectURL(url)
+}
+</script>
+
+<style scoped>
+/* Component container - use VitePress theme variables */
+.migration-tool-container {
+  margin: 2rem 0;
+  max-width: 100%;
+}
+
+.migration-tool-container * {
+  box-sizing: border-box;
+}
+
+/* Version selector */
+.version-selector {
+  background: var(--vp-c-bg-soft);
+  padding: 30px;
+  border-radius: 8px;
+  margin-bottom: 30px;
+  border: 1px solid var(--vp-c-divider);
+}
+
+.selector-group {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 20px;
+  margin-bottom: 20px;
+  flex-wrap: wrap;
+}
+
+.selector-item {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.selector-item label {
+  font-weight: 600;
+  color: var(--vp-c-text-2);
+  font-size: 0.9rem;
+}
+
+.version-dropdown {
+  padding: 12px 20px;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 6px;
+  font-size: 1rem;
+  background: var(--vp-c-bg);
+  color: var(--vp-c-text-1);
+  cursor: pointer;
+  transition: all 0.3s ease;
+  min-width: 200px;
+}
+
+.version-dropdown:hover {
+  border-color: var(--vp-c-brand-1);
+}
+
+.version-dropdown:focus {
+  outline: none;
+  border-color: var(--vp-c-brand-1);
+  box-shadow: 0 0 0 3px var(--vp-c-brand-soft);
+}
+
+.arrow {
+  font-size: 2rem;
+  color: var(--vp-c-brand-1);
+  font-weight: bold;
+}
+
+.btn-primary {
+  background: var(--vp-c-brand-1);
+  color: white;
+  border: none;
+  padding: 14px 40px;
+  font-size: 1.1rem;
+  border-radius: 6px;
+  cursor: pointer;
+  transition: transform 0.2s ease, box-shadow 0.2s ease;
+  font-weight: 600;
+  display: block;
+  margin: 0 auto;
+}
+
+.btn-primary:hover {
+  background: var(--vp-c-brand-2);
+  transform: translateY(-2px);
+}
+
+.btn-primary:active {
+  transform: translateY(0);
+}
+
+/* Results section */
+.results {
+  margin-top: 40px;
+}
+
+.results-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: start;
+  margin-bottom: 20px;
+  flex-wrap: wrap;
+  gap: 20px;
+}
+
+.header-left {
+  flex: 1;
+  min-width: 300px;
+}
+
+.header-right {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  align-items: flex-end;
+}
+
+.filter-buttons {
+  display: flex;
+  gap: 10px;
+  flex-wrap: wrap;
+  align-items: center;
+}
+
+.results-header h3 {
+  font-size: 1.8rem;
+  color: var(--vp-c-text-1);
+  margin-bottom: 12px;
+  margin-top: 0;
+}
+
+/* Search bar */
+.search-container {
+  position: relative;
+  max-width: 400px;
+}
+
+.search-input {
+  width: 100%;
+  padding: 10px 36px 10px 12px;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 6px;
+  font-size: 1rem;
+  background: var(--vp-c-bg);
+  color: var(--vp-c-text-1);
+  transition: all 0.3s ease;
+}
+
+.search-input:focus {
+  outline: none;
+  border-color: var(--vp-c-brand-1);
+  box-shadow: 0 0 0 3px var(--vp-c-brand-soft);
+}
+
+.clear-search {
+  position: absolute;
+  right: 8px;
+  top: 50%;
+  transform: translateY(-50%);
+  background: var(--vp-c-default-soft);
+  color: var(--vp-c-text-2);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 50%;
+  width: 24px;
+  height: 24px;
+  cursor: pointer;
+  font-size: 1rem;
+  line-height: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: all 0.2s ease;
+}
+
+.clear-search:hover {
+  background: var(--vp-c-danger-soft);
+  color: var(--vp-c-danger-1);
+  border-color: var(--vp-c-danger-1);
+}
+
+.btn-export {
+  background: var(--vp-c-brand-1);
+  color: white;
+  border: 1px solid var(--vp-c-brand-1);
+  padding: 8px 16px;
+  font-size: 0.9rem;
+  border-radius: 20px;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  font-weight: 500;
+  white-space: nowrap;
+}
+
+.btn-export:hover {
+  background: var(--vp-c-brand-2);
+  border-color: var(--vp-c-brand-2);
+  transform: translateY(-1px);
+}
+
+.filter-btn {
+  padding: 8px 16px;
+  border: 1px solid var(--vp-c-divider);
+  background: var(--vp-c-bg);
+  color: var(--vp-c-text-1);
+  border-radius: 20px;
+  cursor: pointer;
+  transition: all 0.3s ease;
+  font-size: 0.9rem;
+  font-weight: 500;
+}
+
+.filter-btn:hover {
+  border-color: var(--vp-c-brand-1);
+  color: var(--vp-c-brand-1);
+}
+
+.filter-btn.active {
+  background: var(--vp-c-brand-1);
+  color: white;
+  border-color: var(--vp-c-brand-1);
+}
+
+/* Migration list */
+.migration-list {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+}
+
+.migration-card {
+  background: var(--vp-c-bg-soft);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 8px;
+  padding: 20px;
+  transition: all 0.3s ease;
+  border-left: 4px solid var(--vp-c-divider);
+}
+
+.migration-card:hover {
+  box-shadow: 0 4px 12px var(--vp-c-shadow-1);
+  transform: translateY(-2px);
+}
+
+.migration-card.severity-high {
+  border-left-color: #dc3545;
+}
+
+.migration-card.severity-medium {
+  border-left-color: #ffc107;
+}
+
+.migration-card.severity-low {
+  border-left-color: #28a745;
+}
+
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: start;
+  margin-bottom: 12px;
+  gap: 20px;
+  flex-wrap: wrap;
+}
+
+.card-header h4 {
+  font-size: 1.4rem;
+  color: var(--vp-c-text-1);
+  flex: 1;
+  margin: 0;
+}
+
+.badges {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.badge {
+  padding: 4px 12px;
+  border-radius: 12px;
+  font-size: 0.8rem;
+  font-weight: 500;
+  white-space: nowrap;
+  border: 1px solid;
+}
+
+.severity-high {
+  background: rgba(220, 53, 69, 0.1);
+  color: #c9302c;
+  border-color: rgba(220, 53, 69, 0.3);
+}
+
+.dark .severity-high {
+  background: rgba(220, 53, 69, 0.15);
+  color: #ff6b6b;
+  border-color: rgba(220, 53, 69, 0.4);
+}
+
+.severity-medium {
+  background: rgba(255, 193, 7, 0.1);
+  color: #d39e00;
+  border-color: rgba(255, 193, 7, 0.3);
+}
+
+.dark .severity-medium {
+  background: rgba(255, 193, 7, 0.15);
+  color: #ffc107;
+  border-color: rgba(255, 193, 7, 0.4);
+}
+
+.severity-low {
+  background: rgba(40, 167, 69, 0.1);
+  color: #28a745;
+  border-color: rgba(40, 167, 69, 0.3);
+}
+
+.dark .severity-low {
+  background: rgba(40, 167, 69, 0.15);
+  color: #5cb85c;
+  border-color: rgba(40, 167, 69, 0.4);
+}
+
+.category-badge {
+  background: var(--vp-c-default-soft);
+  color: var(--vp-c-text-2);
+  border-color: var(--vp-c-divider);
+}
+
+.action-required {
+  background: rgba(255, 107, 107, 0.1);
+  color: #d9534f;
+  border-color: rgba(255, 107, 107, 0.3);
+}
+
+.dark .action-required {
+  background: rgba(255, 107, 107, 0.15);
+  color: #ff6b6b;
+  border-color: rgba(255, 107, 107, 0.4);
+}
+
+.version-info {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 12px;
+}
+
+.version-tag {
+  background: var(--vp-c-default-soft);
+  padding: 4px 12px;
+  border-radius: 4px;
+  font-weight: 600;
+  color: var(--vp-c-text-2);
+  font-size: 0.9rem;
+}
+
+.version-info .arrow {
+  font-size: 1rem;
+  color: var(--vp-c-text-3);
+}
+
+.description {
+  color: var(--vp-c-text-2);
+  margin-bottom: 16px;
+  line-height: 1.6;
+}
+
+.steps, .references {
+  margin-top: 16px;
+}
+
+.steps h5, .references h5 {
+  color: var(--vp-c-text-1);
+  margin-bottom: 8px;
+  font-size: 1rem;
+  margin-top: 0;
+}
+
+.steps ol {
+  padding-left: 24px;
+  margin: 0;
+}
+
+.steps li {
+  margin-bottom: 8px;
+  color: var(--vp-c-text-2);
+}
+
+.references ul {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.references li {
+  margin-bottom: 6px;
+}
+
+.references a {
+  color: var(--vp-c-brand-1);
+  text-decoration: none;
+  word-break: break-all;
+}
+
+.references a:hover {
+  color: var(--vp-c-brand-2);
+  text-decoration: underline;
+}
+
+.no-results {
+  text-align: center;
+  padding: 60px 20px;
+  color: var(--vp-c-text-2);
+  font-size: 1.2rem;
+}
+
+/* Responsive design */
+@media (max-width: 768px) {
+  .version-selector {
+    padding: 20px;
+  }
+
+  .selector-group {
+    flex-direction: column;
+    gap: 15px;
+  }
+
+  .arrow {
+    transform: rotate(90deg);
+  }
+
+  .version-dropdown {
+    width: 100%;
+  }
+
+  .results-header {
+    flex-direction: column;
+    align-items: start;
+  }
+
+  .header-left,
+  .header-right {
+    width: 100%;
+  }
+
+  .header-right {
+    align-items: stretch;
+  }
+
+  .search-container {
+    max-width: 100%;
+  }
+
+  .filter-buttons {
+    width: 100%;
+    justify-content: flex-start;
+  }
+
+  .btn-export {
+    width: auto;
+  }
+
+  .card-header {
+    flex-direction: column;
+    align-items: start;
+  }
+}
+</style>
diff --git a/.vitepress/theme/index.ts b/.vitepress/theme/index.ts
index 18433e6ad3..0de669ac2c 100644
--- a/.vitepress/theme/index.ts
+++ b/.vitepress/theme/index.ts
@@ -11,6 +11,7 @@ import Concept from './components/Concept.vue'
 import Since from './components/Since.vue';
 import UnderConstruction from './components/UnderConstruction.vue';
 import CfgInspect from './components/ConfigInspect.vue';
+import MigrationTool from './components/MigrationTool.vue';
 import TwoslashFloatingVue from '@shikijs/vitepress-twoslash/client'
 
 import '@shikijs/vitepress-twoslash/style.css'
@@ -35,6 +36,7 @@ export default {
     ctx.app.component('Concept', Concept)
     ctx.app.component('Since', Since)
     ctx.app.component('UnderConstruction', UnderConstruction)
+    ctx.app.component('MigrationTool', MigrationTool)
     ctx.app.use(TwoslashFloatingVue)
   }
 }
\ No newline at end of file
diff --git a/tools/_menu.md b/tools/_menu.md
index cc2e00d4e5..c50169484a 100644
--- a/tools/_menu.md
+++ b/tools/_menu.md
@@ -3,6 +3,7 @@
 # [Hybrid Testing w/ cds bind](./cds-bind)
 # [Editors & IDEs](cds-editors)
 # [CDS 2 TypeScript](cds-typer)
+# [CAP Migration Tool](migration)
 
 # [CLI Plugin APIs](apis/)
 
diff --git a/tools/assets/migration-data.json b/tools/assets/migration-data.json
new file mode 100644
index 0000000000..b021aff911
--- /dev/null
+++ b/tools/assets/migration-data.json
@@ -0,0 +1,562 @@
+{
+  "versions": [
+    "4.0",
+    "5.0",
+    "6.0",
+    "7.0",
+    "8.0",
+    "9.0"
+  ],
+  "migrations": [
+    {
+      "id": "cds9-transactional-event-queues",
+      "sourceVersion": "8.0",
+      "targetVersion": "9.0",
+      "title": "Transactional Event Queues Enabled by Default",
+      "category": "Breaking Change",
+      "severity": "high",
+      "description": "Event queues are enabled by default. A database deployment is required when migrating to cds9/CAP Java 4 if the persistent outbox was not yet used.",
+      "actionRequired": true,
+      "steps": [
+        "If this is an issue for your project, you can opt out by adding `cds.requires.queue = false` (for Node.js and Java projects)",
+        "Note that the table name remains `cds.outbox.Messages` for compatibility",
+        "`cds.outboxed(srv)` is kept as a synonym for the new `cds.queued(srv)`"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2025/may25#enabled-by-default",
+        "https://cap.cloud.sap/docs/guides/messaging/task-queues"
+      ]
+    },
+    {
+      "id": "cds9-association-to-many",
+      "sourceVersion": "8.0",
+      "targetVersion": "9.0",
+      "title": "Association to Many Without ON Conditions",
+      "category": "Breaking Change",
+      "severity": "high",
+      "description": "A to-many association with missing ON condition is now treated as an unspecified association and cannot be generically served.",
+      "actionRequired": true,
+      "steps": [
+        "If you meant to declare an association to many, correct it: `books: Association to many Books on books.author = $self;`",
+        "If you meant to declare a managed association to one, correct it: `books: Association to Books;`",
+        "If it was correctly modelled as unspecified, ensure you don't deploy such entities to the database and handle them with custom handlers"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2025/may25#unspecified-assoc"
+      ]
+    },
+    {
+      "id": "cds9-now-transaction-time",
+      "sourceVersion": "8.0",
+      "targetVersion": "9.0",
+      "title": "$now is Transaction Time",
+      "category": "Breaking Change",
+      "severity": "medium",
+      "description": "$now is now translated to `session_context($now)` and reflects the transaction time pinned by the CAP runtimes.",
+      "actionRequired": true,
+      "steps": [
+        "If you need the old behavior, replace `$now` by `current_timestamp` in your models",
+        "Exception: In `default` clause, `$now` is still mapped to `current_timestamp`"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2025/may25#now-is-transaction-time"
+      ]
+    },
+    {
+      "id": "cds9-skipped-native-hana-associations",
+      "sourceVersion": "8.0",
+      "targetVersion": "9.0",
+      "title": "Skipped Native Associations for SAP HANA",
+      "category": "Breaking Change",
+      "severity": "medium",
+      "description": "CDS associations are no longer reflected in database tables and views by native HANA associations to reduce deployment times.",
+      "actionRequired": true,
+      "steps": [
+        "First deployment after upgrading may take longer as each entity with associations is touched",
+        "If you need native HANA associations, switch them back on through `cds.sql.native_hana_associations:true`",
+        "Ensure your project uses faster table changes on SAP HANA (ALTER TABLE ADD COLUMN)"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2025/may25#skipped-native-associations-for-sap-hana",
+        "https://cap.cloud.sap/docs/guides/databases-hana#native-associations"
+      ]
+    },
+    {
+      "id": "cds9-removed-hdbcds-format",
+      "sourceVersion": "8.0",
+      "targetVersion": "9.0",
+      "title": "Removed hdbcds Format",
+      "category": "Breaking Change",
+      "severity": "high",
+      "description": "The deploy format `hdbcds` for SAP HANA has been removed. Switch to default deploy format `hdbtable`.",
+      "actionRequired": true,
+      "steps": [
+        "Switch to the default deploy format `hdbtable` instead",
+        "This is not relevant for SAP HANA Cloud where `hdbcds` was never available"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2025/may25#removed-hdbcds-format",
+        "https://cap.cloud.sap/docs/cds/compiler/hdbcds-to-hdbtable"
+      ]
+    },
+    {
+      "id": "cds9-improved-error-handling",
+      "sourceVersion": "8.0",
+      "targetVersion": "9.0",
+      "title": "Improved Error Handling",
+      "category": "Enhancement",
+      "severity": "low",
+      "description": "Error handling has been overhauled with reasonable `code` properties and improved sanitation.",
+      "actionRequired": false,
+      "steps": [
+        "Error responses now include reasonable `code` properties (e.g., `ASSERT_FORMAT`)",
+        "Error sanitation now only done in production, not in development profiles",
+        "Input validation errors are now logged as warnings only, not as errors",
+        "Tests may need adjustment if they checked error responses by deep object equality"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2025/may25#improved-error-handling",
+        "https://cap.cloud.sap/docs/node.js/events#req-reject"
+      ]
+    },
+    {
+      "id": "cds9-nodejs-version",
+      "sourceVersion": "8.0",
+      "targetVersion": "9.0",
+      "title": "Node.js Version Update",
+      "category": "Requirement",
+      "severity": "high",
+      "description": "CAP Node.js v9 requires minimum Node.js 20, with Node.js 22 (LTS) recommended.",
+      "actionRequired": true,
+      "steps": [
+        "Upgrade your Node.js installation to at least version 20",
+        "Recommended: Use Node.js 22 (LTS)"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2025/may25#cap-node-js-v9",
+        "https://nodejs.org"
+      ]
+    },
+    {
+      "id": "cds9-java-version",
+      "sourceVersion": "3.0",
+      "targetVersion": "4.0",
+      "title": "Java Version Update",
+      "category": "Requirement",
+      "severity": "high",
+      "description": "CAP Java v4 requires minimum Java 17 and Maven 3.6.3.",
+      "actionRequired": true,
+      "steps": [
+        "Upgrade to Java 17 or higher",
+        "Ensure Maven is at least version 3.6.3",
+        "Update minimum cds-dk to ^8"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2025/may25#cap-java-v4",
+        "https://cap.cloud.sap/docs/java/versions#dependencies-version-4"
+      ]
+    },
+    {
+      "id": "cds8-new-database-services",
+      "sourceVersion": "7.0",
+      "targetVersion": "8.0",
+      "title": "New Database Services (GA)",
+      "category": "Breaking Change",
+      "severity": "high",
+      "description": "New database services for SQLite, PostgreSQL, and SAP HANA are now GA and the default.",
+      "actionRequired": true,
+      "steps": [
+        "Install new database service packages: `@cap-js/sqlite`, `@cap-js/postgres`, `@cap-js/hana`",
+        "Remove direct dependencies to database driver packages like `sqlite3`, `hdb`, or `@sap/hana-client`",
+        "The new services auto-wire themselves when installed",
+        "Read migration guides for database-specific changes"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2024/jun24#new-database-services-ga",
+        "https://github.com/cap-js/cds-dbs",
+        "https://cap.cloud.sap/docs/guides/databases-sqlite#migration"
+      ]
+    },
+    {
+      "id": "cds8-new-protocol-adapters",
+      "sourceVersion": "7.0",
+      "targetVersion": "8.0",
+      "title": "New Protocol Adapters (GA)",
+      "category": "Breaking Change",
+      "severity": "medium",
+      "description": "Completely re-implemented OData and REST adapters with reduced code base and improved performance.",
+      "actionRequired": true,
+      "steps": [
+        "Review changes to `@odata.context` in responses (optimized to minimal required information)",
+        "$batch requests are now processed sequentially",
+        "$search arguments are captured as plain `val` in CQN objects",
+        "HTTP 401 responses for basic authentication don't contain JSON `{error}` body anymore",
+        "If needed, re-enable old adapters with `cds.features.odata_new_adapter = false` (deprecated)"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2024/jun24#new-protocol-adapters-ga"
+      ]
+    },
+    {
+      "id": "cds8-changed-service-path",
+      "sourceVersion": "7.0",
+      "targetVersion": "8.0",
+      "title": "Changed Default Service Path",
+      "category": "Breaking Change",
+      "severity": "high",
+      "description": "Services are now served at endpoints including a protocol prefix (e.g., `/odata/v4/admin` instead of `/admin`).",
+      "actionRequired": true,
+      "steps": [
+        "Update consumers of endpoints (e.g., SAP Fiori Elements applications)",
+        "Option 1: Turn on compat flag `cds.features.serve_on_root = true`",
+        "Option 2: Specify absolute paths with `@path` annotation (e.g., `@path:'/admin'`)",
+        "Recommended: Switch to the new endpoint scheme as the old one is deprecated"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2024/jun24#changed-default-service-path",
+        "https://cap.cloud.sap/docs/node.js/cds-serve#cds-protocols"
+      ]
+    },
+    {
+      "id": "cds8-lean-draft",
+      "sourceVersion": "7.0",
+      "targetVersion": "8.0",
+      "title": "Lean Draft is the Sole Implementation",
+      "category": "Breaking Change",
+      "severity": "medium",
+      "description": "Lean draft is now the only draft implementation. Old draft implementation has been removed.",
+      "actionRequired": true,
+      "steps": [
+        "Migrate to lean draft implementation",
+        "Compatibility flag `cds.fiori.draft_compat` is still available in cds8 but will be removed",
+        "All draft sibling entities are now fully compliant CSN entities",
+        "Update handlers to differentiate between active and draft instances"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2024/jun24#lean-draft",
+        "https://cap.cloud.sap/docs/node.js/fiori#draft-support"
+      ]
+    },
+    {
+      "id": "cds8-nodejs-18",
+      "sourceVersion": "7.0",
+      "targetVersion": "8.0",
+      "title": "Node.js 18 Required",
+      "category": "Requirement",
+      "severity": "high",
+      "description": "cds 8 requires Node.js 16 minimum, with Node.js 18 recommended as LTS.",
+      "actionRequired": true,
+      "steps": [
+        "Upgrade to Node.js 18 (LTS recommended)",
+        "Node.js 16 is not recommended as it reaches end of life in September 2023"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2024/jun24#upgrade-to-node-js-18",
+        "https://nodejs.org"
+      ]
+    },
+    {
+      "id": "cds8-java-spring-boot-3",
+      "sourceVersion": "2.0",
+      "targetVersion": "3.0",
+      "title": "Spring Boot 3",
+      "category": "Requirement",
+      "severity": "high",
+      "description": "CAP Java now runs with Spring Boot 3, leveraging JDK 17 baseline and Jakarta EE 9.",
+      "actionRequired": true,
+      "steps": [
+        "Upgrade to Spring Boot 3",
+        "Update to Jakarta EE 9 (namespace change from javax.* to jakarta.*)",
+        "Review Spring Boot 3 migration guide",
+        "Note: Spring Boot 2.7 runs out of OSS support in November 2023"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2024/jun24#spring-boot-3"
+      ]
+    },
+    {
+      "id": "cds7-upgrade-nodejs-18",
+      "sourceVersion": "6.0",
+      "targetVersion": "7.0",
+      "title": "Upgrade to Node.js 18",
+      "category": "Requirement",
+      "severity": "high",
+      "description": "Node.js 14 is out of maintenance and cds 7 requires Node.js 16 minimum. Node.js 18 LTS is recommended.",
+      "actionRequired": true,
+      "steps": [
+        "Upgrade your Node.js installation to at least version 16",
+        "Recommended: Use Node.js 18 (LTS)",
+        "Note: Node.js 16 reaches end of life in September 2023"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2023/jun23#upgrade-to-node-js-18",
+        "https://nodejs.org"
+      ]
+    },
+    {
+      "id": "cds7-upgrade-java-17",
+      "sourceVersion": "1.x",
+      "targetVersion": "2.0",
+      "title": "Upgrade to Java 17",
+      "category": "Requirement",
+      "severity": "high",
+      "description": "For Java projects using the new CAP Java SDK 2, an update to Java 17 is mandatory.",
+      "actionRequired": true,
+      "steps": [
+        "Upgrade to Java 17 or higher",
+        "In SAP Business Application Studio, trigger explicitly using command 'Java: Set Default JDK' (F1)"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2023/jun23#upgrade-to-java-17"
+      ]
+    },
+    {
+      "id": "cds7-cds-serve-script",
+      "sourceVersion": "6.0",
+      "targetVersion": "7.0",
+      "title": "Use cds-serve as Start Script",
+      "category": "Breaking Change",
+      "severity": "medium",
+      "description": "The executable from @sap/cds has been renamed from 'cds' to 'cds-serve' to avoid conflicts with @sap/cds-dk.",
+      "actionRequired": true,
+      "steps": [
+        "Change your npm start script from `cds run` to `cds-serve`",
+        "Example: `\"start\": \"cds-serve\"`"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2023/jun23#use-cds-serve-as-start-script"
+      ]
+    },
+    {
+      "id": "cds7-migrate-mtxs",
+      "sourceVersion": "6.0",
+      "targetVersion": "7.0",
+      "title": "Migrate to @sap/cds-mtxs",
+      "category": "Breaking Change",
+      "severity": "high",
+      "description": "The old MTX package @sap/cds-mtx is no longer supported with cds 7. Must use @sap/cds-mtxs.",
+      "actionRequired": true,
+      "steps": [
+        "Install @sap/cds-mtxs package",
+        "Remove @sap/cds-mtx package",
+        "Follow migration guide for configuration changes",
+        "Update deployment configuration"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2023/jun23#migrate-to-sap-cds-mtxs",
+        "https://cap.cloud.sap/docs/guides/multitenancy/old-mtx-migration"
+      ]
+    },
+    {
+      "id": "cds7-default-string-length",
+      "sourceVersion": "6.0",
+      "targetVersion": "7.0",
+      "title": "Default String Length Changed",
+      "category": "Breaking Change",
+      "severity": "medium",
+      "description": "Default length for cds.String changed from 5000 to 255 for all database dialects except HANA.",
+      "actionRequired": true,
+      "steps": [
+        "Review all String types without explicit length",
+        "For production, always specify the length explicitly",
+        "If needed, configure default: `cds.cdsc.defaultStringLength: 5000`"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2023/jun23#default-string-length"
+      ]
+    },
+    {
+      "id": "cds7-simplified-handlers",
+      "sourceVersion": "6.0",
+      "targetVersion": "7.0",
+      "title": "Simplified After Handlers",
+      "category": "Breaking Change",
+      "severity": "medium",
+      "description": "The result argument of after handlers is always an array now.",
+      "actionRequired": true,
+      "steps": [
+        "Update after handlers to expect result as array",
+        "Remove code that handled no result, single object, and array cases separately",
+        "Use `req.query.SELECT.one` if you need to differentiate single entry vs collection"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2023/jun23#simplified-handlers"
+      ]
+    },
+    {
+      "id": "cds7-protocol-endpoints",
+      "sourceVersion": "6.0",
+      "targetVersion": "7.0",
+      "title": "New Protocol-Specific Service Endpoints",
+      "category": "Breaking Change",
+      "severity": "high",
+      "description": "Services served via multiple protocols require separate endpoints with protocol prefixes.",
+      "actionRequired": true,
+      "steps": [
+        "Update service paths to include protocol prefix (e.g., `/odata/v4/admin`)",
+        "Update OData v2 proxy to version >= 1.11",
+        "For compatibility, use `cds.features.serve_on_root = true` or specify absolute paths with `@path`",
+        "Prefer switching to the new endpoint scheme (old one is deprecated)"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2023/jun23#new-protocol-specific-service-endpoints"
+      ]
+    },
+    {
+      "id": "cds6-auth-enforced-production",
+      "sourceVersion": "5.0",
+      "targetVersion": "6.0",
+      "title": "Authentication Enforced in Production",
+      "category": "Breaking Change",
+      "severity": "high",
+      "description": "All CAP service endpoints are now authenticated by default in production scenarios regardless of the authorization model.",
+      "actionRequired": true,
+      "steps": [
+        "Ensure authentication strategy is properly configured (e.g., XSUAA)",
+        "In Node.js, disable with feature flag `cds.env.requires.auth.restrict_all_services: false` if needed",
+        "For Java, set `cds.security.openUnrestrictedEndpoints = true` to open only explicitly exposed endpoints",
+        "Model open endpoints explicitly with `@restrict` or `@requires` annotations"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2022/jun22#auth-by-default"
+      ]
+    },
+    {
+      "id": "cds6-db-constraints",
+      "sourceVersion": "5.0",
+      "targetVersion": "6.0",
+      "title": "Database-Level Constraints (Beta)",
+      "category": "Enhancement",
+      "severity": "medium",
+      "description": "Database-level integrity constraints for managed associations are now available as beta feature.",
+      "actionRequired": false,
+      "steps": [
+        "Enable DB-level constraints explicitly with `cds.env.features.assert_integrity = 'db'`",
+        "Service-level integrity checks are deprecated and planned for removal",
+        "Use `@assert.target` annotation for user-friendly input validation on associations",
+        "DB constraints are available for SQLite and SAP HANA dialects"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2022/jun22#db-constraints",
+        "https://cap.cloud.sap/docs/guides/databases#database-constraints"
+      ]
+    },
+    {
+      "id": "cds6-improved-read-after-write",
+      "sourceVersion": "5.0",
+      "targetVersion": "6.0",
+      "title": "Improved Read After Write",
+      "category": "Breaking Change",
+      "severity": "medium",
+      "description": "OData CREATE, UPDATE, EDIT, and SAVE operations now followed by additional READ request to application service.",
+      "actionRequired": true,
+      "steps": [
+        "Only need to register READ handlers to adjust responses (including virtual properties)",
+        "Remove duplicate handler logic for CREATE/UPDATE events that mimicked READ behavior",
+        "Be aware: users only see full response if authorized for READ",
+        "Note: If subsequent READ fails, response status is 204 without payload"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2022/jun22#read-after-write"
+      ]
+    },
+    {
+      "id": "cds6-sap-cloud-sdk-v2",
+      "sourceVersion": "5.0",
+      "targetVersion": "6.0",
+      "title": "SAP Cloud SDK v2 (Node.js)",
+      "category": "Breaking Change",
+      "severity": "medium",
+      "description": "SAP Cloud SDK is now an optional dependency that must be installed explicitly when needed.",
+      "actionRequired": true,
+      "steps": [
+        "Install required SAP Cloud SDK v2 packages if consuming remote OData services",
+        "Similar to SAP HANA driver, it's no longer bundled by default",
+        "Update package.json dependencies accordingly"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2022/jun22#sap-cloud-sdk-v2-node-js"
+      ]
+    },
+    {
+      "id": "cds6-nodejs-12-dropped",
+      "sourceVersion": "5.0",
+      "targetVersion": "6.0",
+      "title": "Dropped Support for Node.js v12",
+      "category": "Requirement",
+      "severity": "high",
+      "description": "Node.js v12 is no longer supported. Minimum required version is Node.js v14.15, with v16 recommended.",
+      "actionRequired": true,
+      "steps": [
+        "Upgrade Node.js installation to at least version 14.15",
+        "Recommended: Use Node.js v16 (Active LTS version at the time)",
+        "Update CI/CD pipelines to use supported Node.js versions",
+        "Note: CAP cds 5 goes into Maintenance Status, cds 4 reaches End of Life"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2022/jun22#dropped-support-for-node-js-v12"
+      ]
+    },
+    {
+      "id": "cds5-exists-predicates",
+      "sourceVersion": "4.0",
+      "targetVersion": "5.0",
+      "title": "Exists Predicates in CQL",
+      "category": "Enhancement",
+      "severity": "low",
+      "description": "Support for exists predicates with path expressions in CQL for expressing complex relationships.",
+      "actionRequired": false,
+      "steps": [
+        "Use exists predicates to simplify complex queries: `SELECT FROM Authors WHERE exists books.pages[wordcount > 1000]`",
+        "Leverage exists predicates for instance-based authorization in @restrict annotations",
+        "Supported in CDS compiler, Node.js runtime, and Java runtime (anyMatch predicate)",
+        "Note: Paths inside infix filters are not yet supported"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2021/dec21#exists-predicates-in-cql",
+        "https://cap.cloud.sap/docs/cds/cql#exists-predicate"
+      ]
+    },
+    {
+      "id": "cds5-persistent-outbox",
+      "sourceVersion": "4.0",
+      "targetVersion": "5.0",
+      "title": "Persistent Outbox (Beta)",
+      "category": "Enhancement",
+      "severity": "low",
+      "description": "Persistent outbox combines asynchronism with resilience for message emit and audit logging.",
+      "actionRequired": false,
+      "steps": [
+        "Enable persistent outbox for messaging and audit logging services",
+        "Messages are stored in persistence and emitted after transaction success",
+        "Automatic retry with exponential backoff for failed emits",
+        "Ensures no lost logs or ghost logs in case of crashes or rollbacks"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2021/dec21#persistent-outbox-beta",
+        "https://cap.cloud.sap/docs/java/outbox#persistent",
+        "https://cap.cloud.sap/docs/node.js/queue#persistent-queue"
+      ]
+    },
+    {
+      "id": "cds5-sql-window-functions",
+      "sourceVersion": "4.0",
+      "targetVersion": "5.0",
+      "title": "SQL Window Functions Support",
+      "category": "Enhancement",
+      "severity": "low",
+      "description": "CQL now supports syntax for SQL window functions.",
+      "actionRequired": false,
+      "steps": [
+        "Use window functions in CQL: `sum(x) over (partition by a order by b rows between unbounded preceding and current row) as s`",
+        "No semantic checks performed - translated directly to SQL",
+        "Consult your database documentation for supported window functions",
+        "Useful for advanced analytics and reporting queries"
+      ],
+      "references": [
+        "https://cap.cloud.sap/docs/releases/archive/2021/dec21#sql-window-functions",
+        "https://cap.cloud.sap/docs/cds/cxn#function-calls"
+      ]
+    }
+  ]
+}
diff --git a/tools/migration.md b/tools/migration.md
new file mode 100644
index 0000000000..f5f4df9e7d
--- /dev/null
+++ b/tools/migration.md
@@ -0,0 +1,33 @@
+---
+status: released
+---
+
+# CAP Migration Tool
+
+This interactive tool helps you identify migration steps needed when upgrading between different versions of the SAP Cloud Application Programming Model (CAP).
+
+::: info Data Source
+Migration data is sourced from [CAP Release Notes](https://cap.cloud.sap/docs/releases/).
+:::
+
+<ClientOnly>
+  <MigrationTool />
+</ClientOnly>
+
+## How to Use
+
+1. **Select Source Version** - Choose your current CAP version
+2. **Select Target Version** - Choose the version you want to upgrade to  
+3. **Show Migration Steps** - Click the button to display all relevant changes
+4. **Filter & Search** - Use filters to focus on specific types of changes:
+   - Breaking Changes
+   - Requirements
+   - Enhancements
+5. **Export Checklist** - Download a markdown file with all migration steps
+
+## Features
+
+- **Version Range Selection**: Automatically identifies all migrations between any two versions
+- **Smart Filtering**: Focus on what matters most to your project
+- **Search**: Quickly find specific migrations by keyword
+- **Export**: Generate a markdown checklist for documentation or team sharing