diff --git a/.vitepress/config/constants.ts b/.vitepress/config/constants.ts
index 5d2852f..5b41f75 100644
--- a/.vitepress/config/constants.ts
+++ b/.vitepress/config/constants.ts
@@ -19,7 +19,7 @@ export const navItemOrder: Record<string, string[]> = {
     "develop-from-scratch",
   ],
   sdk: ["quickstart", "cli", "services", "generator"],
-  reference: ["api", "platform", "concepts", "infrastructure"],
+  reference: ["changelog","security", "api", "platform", "concepts", "infrastructure"],
   "getting-started": ["quickstart", "core-concepts", "console"],
   "app-shell": [
     "introduction",
@@ -93,6 +93,7 @@ export const sidebarItemOrder: Record<string, string[]> = {
     "login",
   ],
   function: ["overview", "builtin-interfaces"],
+  reference: ["changelog","api", "platform", "concepts", "infrastructure", "security"],
   "app-shell": [
     "introduction",
     "quickstart",
diff --git a/.vitepress/config/sidebar.ts b/.vitepress/config/sidebar.ts
index 5d9c458..e303007 100644
--- a/.vitepress/config/sidebar.ts
+++ b/.vitepress/config/sidebar.ts
@@ -89,16 +89,23 @@ export function generateSidebar(
   for (const dirName of sortedDirs) {
     const subdirPath = path.join(dir, dirName);
     const subdirBasePath = `${basePath}/${dirName}`;
+    const dirIndexPath = path.join(fullPath, dirName, "index.md");
+    const hasIndex = fs.existsSync(dirIndexPath);
     const subItems = generateSidebar(docsDir, subdirPath, subdirBasePath, depth + 1);
 
+    // Add directory if it has sub-items OR if it has an index.md
     if (subItems.length > 0) {
-      // Check if directory has an index.md to read title from
-      const dirIndexPath = path.join(fullPath, dirName, "index.md");
       items.push({
-        text: toTitle(dirName, { filePath: fs.existsSync(dirIndexPath) ? dirIndexPath : undefined }),
+        text: toTitle(dirName, { filePath: hasIndex ? dirIndexPath : undefined }),
         collapsed: depth > 0,
         items: subItems,
       });
+    } else if (hasIndex) {
+      // Directory with only index.md - add as direct link
+      items.push({
+        text: toTitle(dirName, { filePath: dirIndexPath }),
+        link: subdirBasePath,
+      });
     }
   }
 
diff --git a/.vitepress/env.d.ts b/.vitepress/env.d.ts
index b08467c..def6a72 100644
--- a/.vitepress/env.d.ts
+++ b/.vitepress/env.d.ts
@@ -5,3 +5,4 @@ declare module "*.vue" {
   const component: DefineComponent;
   export default component;
 }
+
diff --git a/.vitepress/theme/components/Changelog.vue b/.vitepress/theme/components/Changelog.vue
new file mode 100644
index 0000000..7c7bd2c
--- /dev/null
+++ b/.vitepress/theme/components/Changelog.vue
@@ -0,0 +1,100 @@
+<template>
+  <div class="changelog-container">
+    <FilterTabs v-model="selectedProduct" :options="PRODUCTS" :counts="productCounts" />
+
+    <div v-if="paginatedEntries.length > 0">
+      <div
+        v-for="entry in paginatedEntries"
+        :key="entry.id"
+        class="release-card"
+        :id="anchorId(entry.id)"
+      >
+        <div class="release-card-header">
+          <div class="release-card-meta">
+            <span class="entry-date">{{ formatDate(entry.date) }}</span>
+            <template v-if="entry.product !== 'Platform Core'">
+              <span class="entry-separator">•</span>
+              <a :href="entry.githubUrl" target="_blank" rel="noopener" class="entry-github-link">
+                View on GitHub →
+              </a>
+            </template>
+          </div>
+          <div class="release-card-badges">
+            <span class="product-badge" :data-product="entry.product.toLowerCase().replace(/\s+/g, '-')">
+              {{ entry.product }}
+            </span>
+            <span v-if="entry.product !== 'Platform Core'" class="version-badge" :data-type="entry.versionType">
+              v{{ extractVersion(entry.version) }}
+            </span>
+            <span v-if="entry.breaking" class="breaking-badge">⚠️ Breaking</span>
+          </div>
+        </div>
+
+        <h3 class="entry-title">{{ entry.title }}</h3>
+
+        <div v-if="entry.narrative" class="entry-narrative">
+          <div class="narrative-summary">
+            <strong>What's new:</strong> {{ entry.narrative.summary }}
+          </div>
+          <div v-if="entry.narrative.impact" class="narrative-impact">
+            <strong>Impact:</strong> {{ entry.narrative.impact }}
+          </div>
+          <div v-if="entry.narrative.details?.length" class="narrative-details">
+            <strong>Key changes:</strong>
+            <ul>
+              <li v-for="(detail, i) in entry.narrative.details" :key="i">{{ detail }}</li>
+            </ul>
+          </div>
+          <div v-if="entry.narrative.migration" class="narrative-migration">
+            <strong>⚠️ Migration required:</strong>
+            <div v-html="entry.narrative.migration" />
+          </div>
+        </div>
+
+        <div v-else class="release-body">
+          <p v-for="(para, i) in entry.body.split('\n\n')" :key="i">{{ para }}</p>
+        </div>
+
+      </div>
+    </div>
+
+    <div v-else class="empty-state">
+      <p>No releases found for {{ selectedProduct }}.</p>
+    </div>
+
+    <div v-if="hasMore" class="load-more">
+      <button class="load-more-btn" @click="loadMore">
+        Load More <span class="remaining">({{ remaining }} remaining)</span>
+      </button>
+    </div>
+
+    <div class="changelog-footer">
+      <p class="stats">
+        Showing {{ paginatedEntries.length }} of {{ filteredEntries.length }} releases
+        <span v-if="selectedProduct !== 'All'"> for {{ selectedProduct }}</span>
+      </p>
+      <p class="last-updated">Last updated: {{ formatDate(changelogData.lastUpdated) }}</p>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { data as changelogData } from '../../../docs/reference/changelog/releases.data'
+import { useChangelog, formatDate, PRODUCTS } from '../composables/useChangelog'
+import FilterTabs from './FilterTabs.vue'
+
+const { selectedProduct, filteredEntries, paginatedEntries, hasMore, remaining, loadMore, productCounts } =
+  useChangelog(changelogData)
+
+function extractVersion(version?: string): string {
+  if (!version) return ''
+  const lastAt = version.lastIndexOf('@')
+  return lastAt > 0 ? version.slice(lastAt + 1) : version
+}
+
+function anchorId(id: string): string {
+  return id.replace(/[@/]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '')
+}
+</script>
+
+<style src="../styles/changelog.css" />
diff --git a/.vitepress/theme/components/FilterTabs.vue b/.vitepress/theme/components/FilterTabs.vue
new file mode 100644
index 0000000..59f148a
--- /dev/null
+++ b/.vitepress/theme/components/FilterTabs.vue
@@ -0,0 +1,29 @@
+<template>
+  <div class="filter-tabs">
+    <button
+      v-for="option in options"
+      :key="option"
+      class="filter-tab"
+      :class="{ active: modelValue === option }"
+      :aria-pressed="modelValue === option"
+      @click="$emit('update:modelValue', option)"
+    >
+      {{ option }}<span v-if="counts?.[option] !== undefined" class="filter-tab-count">{{ counts[option] }}</span>
+    </button>
+  </div>
+</template>
+
+<script setup lang="ts">
+// Generic single-select filter tab bar. Stateless — active value is owned by the parent via v-model.
+defineProps<{
+  options: string[]
+  modelValue: string
+  counts?: Record<string, number>
+}>()
+
+defineEmits<{
+  'update:modelValue': [value: string]
+}>()
+</script>
+
+<style src="../styles/filter-tabs.css" />
diff --git a/.vitepress/theme/composables/useChangelog.ts b/.vitepress/theme/composables/useChangelog.ts
new file mode 100644
index 0000000..18a2840
--- /dev/null
+++ b/.vitepress/theme/composables/useChangelog.ts
@@ -0,0 +1,93 @@
+import { ref, computed, watch } from 'vue'
+
+export interface ChangelogNarrative {
+  summary: string
+  impact?: string
+  details?: string[]
+  migration?: string | null
+}
+
+export interface ChangelogItem {
+  id: string
+  date: string
+  product: string
+  version: string
+  versionType: 'major' | 'minor' | 'patch'
+  title: string
+  breaking: boolean
+  githubUrl: string
+  body: string
+  narrative: ChangelogNarrative
+  createdAt: string
+  updatedAt?: string
+}
+
+export interface ChangelogData {
+  lastUpdated: string
+  entries: ChangelogItem[]
+}
+
+// Products shown in the UI — Platform Core is intentionally excluded
+const VISIBLE_PRODUCTS = ['SDK', 'AppShell'] as const
+
+export const PRODUCTS = ['All', ...VISIBLE_PRODUCTS]
+
+export function formatDate(dateString: string): string {
+  if (!dateString) return ''
+  return new Date(dateString).toLocaleDateString('en-US', {
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+  })
+}
+
+export function useChangelog(data: ChangelogData) {
+  const selectedProduct = ref('All')
+  const currentPage = ref(1)
+  const itemsPerPage = 20
+
+  watch(selectedProduct, () => {
+    currentPage.value = 1
+  })
+
+  // Only surface entries for visible products
+  const visibleEntries = data.entries.filter((e) =>
+    (VISIBLE_PRODUCTS as readonly string[]).includes(e.product),
+  )
+
+  const filteredEntries = computed(() =>
+    selectedProduct.value === 'All'
+      ? visibleEntries
+      : visibleEntries.filter((e) => e.product === selectedProduct.value),
+  )
+
+  const paginatedEntries = computed(() =>
+    filteredEntries.value.slice(0, currentPage.value * itemsPerPage),
+  )
+
+  const hasMore = computed(() => paginatedEntries.value.length < filteredEntries.value.length)
+
+  const remaining = computed(() => filteredEntries.value.length - paginatedEntries.value.length)
+
+  const productCounts = computed(() => {
+    const counts: Record<string, number> = { All: visibleEntries.length }
+    for (const entry of visibleEntries) {
+      counts[entry.product] = (counts[entry.product] ?? 0) + 1
+    }
+    return counts
+  })
+
+  function loadMore() {
+    currentPage.value++
+  }
+
+  return {
+    selectedProduct,
+    filteredEntries,
+    paginatedEntries,
+    hasMore,
+    remaining,
+    loadMore,
+    productCounts,
+  }
+}
diff --git a/.vitepress/theme/styles/changelog.css b/.vitepress/theme/styles/changelog.css
new file mode 100644
index 0000000..a3edba2
--- /dev/null
+++ b/.vitepress/theme/styles/changelog.css
@@ -0,0 +1,263 @@
+/* Release card */
+.release-card {
+  padding: 1.5rem 0;
+  border-bottom: 1px solid var(--vp-c-divider);
+}
+
+.release-card:last-child {
+  border-bottom: none;
+}
+
+.release-card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: 1rem;
+  margin-bottom: 0.5rem;
+  flex-wrap: wrap;
+}
+
+.release-card-meta {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  font-size: 0.875rem;
+  color: var(--vp-c-text-2);
+}
+
+.release-card-badges {
+  display: flex;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+  align-items: center;
+}
+
+.release-card-footer {
+  display: flex;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+  margin-top: 1rem;
+}
+
+@media (max-width: 768px) {
+  .release-card-header {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+}
+
+/* Changelog page layout */
+.changelog-container {
+  max-width: 900px;
+  margin: 0 auto;
+  padding: 2rem 0;
+}
+
+/* Badges */
+.product-badge,
+.version-badge,
+.breaking-badge {
+  padding: 0.125rem 0.5rem;
+  border-radius: 4px;
+  font-size: 0.75rem;
+  font-weight: 500;
+}
+
+/* Product badge — per-product colour coding */
+.product-badge {
+  color: white;
+}
+
+.product-badge[data-product="sdk"] {
+  background: #3b82f6;
+}
+
+.product-badge[data-product="appshell"] {
+  background: #8b5cf6;
+}
+
+.product-badge[data-product="platform-core"] {
+  background: #06b6d4;
+}
+
+/* Version badge — colour varies by semver bump type */
+.version-badge {
+  background: var(--vp-c-bg-soft);
+  color: var(--vp-c-text-1);
+  border: 1px solid var(--vp-c-divider);
+}
+
+.version-badge[data-type="major"] {
+  background: #fef2f2;
+  color: #991b1b;
+  border-color: #fecaca;
+}
+
+.version-badge[data-type="minor"] {
+  background: #eff6ff;
+  color: #1e40af;
+  border-color: #bfdbfe;
+}
+
+/* Breaking change badge */
+.breaking-badge {
+  background: #fef2f2;
+  color: #991b1b;
+  border: 1px solid #fecaca;
+}
+
+/* Dark mode overrides for hardcoded light-mode badge colours */
+:root.dark .version-badge[data-type="major"],
+:root.dark .breaking-badge {
+  background: rgba(254, 242, 242, 0.08);
+  color: #fca5a5;
+  border-color: rgba(254, 202, 202, 0.25);
+}
+
+:root.dark .version-badge[data-type="minor"] {
+  background: rgba(239, 246, 255, 0.08);
+  color: #93c5fd;
+  border-color: rgba(191, 219, 254, 0.25);
+}
+
+:root.dark .narrative-migration {
+  background: rgba(254, 242, 242, 0.08);
+  border-color: rgba(254, 202, 202, 0.25);
+  color: #fca5a5;
+}
+
+/* Footer tags */
+.entry-tag {
+  padding: 0.125rem 0.5rem;
+  border-radius: 4px;
+  font-size: 0.75rem;
+  font-weight: 500;
+  background: var(--vp-c-bg-soft);
+  color: var(--vp-c-text-2);
+  border: 1px solid var(--vp-c-divider);
+}
+
+/* Meta row */
+.entry-date {
+  font-weight: 500;
+}
+
+.entry-separator {
+  opacity: 0.5;
+}
+
+.entry-github-link {
+  color: var(--vp-c-text-2);
+  text-decoration: none;
+  transition: color 0.2s;
+}
+
+.entry-github-link:hover {
+  color: var(--vp-c-brand);
+}
+
+/* Entry title */
+.entry-title {
+  margin: 0;
+  font-size: 1.25rem;
+  font-weight: 600;
+  color: var(--vp-c-text-1);
+}
+
+/* Narrative block */
+.entry-narrative {
+  background: var(--vp-c-bg-soft);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 8px;
+  padding: 1.5rem;
+}
+
+.narrative-summary,
+.narrative-impact,
+.narrative-details {
+  margin-bottom: 1rem;
+}
+
+.narrative-summary:last-child,
+.narrative-impact:last-child,
+.narrative-details:last-child {
+  margin-bottom: 0;
+}
+
+.narrative-summary strong,
+.narrative-impact strong,
+.narrative-details strong {
+  color: var(--vp-c-text-1);
+  font-weight: 600;
+}
+
+.narrative-details ul {
+  margin: 0.5rem 0 0 0;
+  padding-left: 1.5rem;
+}
+
+.narrative-details li {
+  margin-bottom: 0.25rem;
+  color: var(--vp-c-text-2);
+}
+
+.narrative-migration {
+  margin-top: 1rem;
+  padding: 1rem;
+  background: #fef2f2;
+  border: 1px solid #fecaca;
+  border-radius: 6px;
+  color: #991b1b;
+}
+
+/* Empty state */
+.empty-state {
+  text-align: center;
+  padding: 3rem 1rem;
+  color: var(--vp-c-text-2);
+}
+
+/* Load more */
+.load-more {
+  text-align: center;
+  margin: 3rem 0;
+}
+
+.load-more-btn {
+  padding: 0.75rem 2rem;
+  background: var(--vp-c-bg-soft);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 6px;
+  color: var(--vp-c-text-1);
+  cursor: pointer;
+  transition: all 0.2s;
+  font-size: 0.9375rem;
+}
+
+.load-more-btn:hover {
+  border-color: var(--vp-c-brand);
+  color: var(--vp-c-brand);
+}
+
+.load-more-btn .remaining {
+  opacity: 0.7;
+  margin-left: 0.5rem;
+}
+
+/* Footer */
+.changelog-footer {
+  margin-top: 3rem;
+  padding-top: 2rem;
+  border-top: 1px solid var(--vp-c-divider);
+  text-align: center;
+  color: var(--vp-c-text-2);
+  font-size: 0.875rem;
+}
+
+.changelog-footer .stats {
+  margin-bottom: 0.5rem;
+}
+
+.changelog-footer .last-updated {
+  opacity: 0.7;
+}
diff --git a/.vitepress/theme/styles/filter-tabs.css b/.vitepress/theme/styles/filter-tabs.css
new file mode 100644
index 0000000..05604cc
--- /dev/null
+++ b/.vitepress/theme/styles/filter-tabs.css
@@ -0,0 +1,45 @@
+.filter-tabs {
+  display: flex;
+  gap: 0.5rem;
+  margin-bottom: 2rem;
+  flex-wrap: wrap;
+}
+
+.filter-tab {
+  padding: 0.5rem 1rem;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 6px;
+  background: var(--vp-c-bg);
+  color: var(--vp-c-text-2);
+  cursor: pointer;
+  transition: all 0.2s;
+  font-size: 0.9rem;
+}
+
+.filter-tab:hover {
+  border-color: var(--vp-c-brand);
+  color: var(--vp-c-brand);
+}
+
+.filter-tab.active {
+  background: var(--vp-c-brand);
+  color: white;
+  border-color: var(--vp-c-brand);
+}
+
+.filter-tab-count {
+  margin-left: 0.375rem;
+  font-size: 0.75rem;
+  opacity: 0.65;
+}
+
+@media (max-width: 768px) {
+  .filter-tabs {
+    gap: 0.375rem;
+  }
+
+  .filter-tab {
+    padding: 0.375rem 0.75rem;
+    font-size: 0.875rem;
+  }
+}
diff --git a/README.md b/README.md
index f79006b..c18da0b 100644
--- a/README.md
+++ b/README.md
@@ -68,6 +68,19 @@ docs/
 └── scripts/             # Utility scripts
 ```
 
+## How to Update Release Notes
+
+1. **Generate narratives**:
+
+```bash
+o-tailor-release-digest --output json --days 7 --output-file docs/docs/changelog/narratives.json
+```
+
+2. **Merge into data.json**:
+```bash
+node scripts/merge-narratives.js
+```
+
 ## Contributing
 
 When adding new documentation:
diff --git a/docs/reference/changelog/index.md b/docs/reference/changelog/index.md
new file mode 100644
index 0000000..b7eb886
--- /dev/null
+++ b/docs/reference/changelog/index.md
@@ -0,0 +1,13 @@
+---
+layout: doc
+title: Changelog
+description: Latest updates and releases for Tailor Platform
+---
+
+<script setup>
+import Changelog from '../../../.vitepress/theme/components/Changelog.vue'
+</script>
+
+# Changelog
+
+<Changelog />
diff --git a/docs/reference/changelog/releases.data.ts b/docs/reference/changelog/releases.data.ts
new file mode 100644
index 0000000..899065f
--- /dev/null
+++ b/docs/reference/changelog/releases.data.ts
@@ -0,0 +1,94 @@
+import type { ChangelogData, ChangelogItem } from '../../../.vitepress/theme/composables/useChangelog'
+
+declare const data: ChangelogData
+export { data }
+
+const ENDPOINT = 'https://changelog-lu2nvur63d.erp.dev/query'
+
+const PAGE_SIZE = 100
+
+const QUERY = (first: number, after: string | null) => `
+  query {
+    releases(first: ${first}${after ? `, after: "${after}"` : ''}) {
+      edges {
+        node {
+          id
+          productType
+          version
+          versionType
+          title
+          releaseDate
+          githubUrl
+          body
+          breaking
+          narrativeSummary
+          narrativeImpact
+          narrativeDetails
+          narrativeMigration
+          createdAt
+          updatedAt
+        }
+      }
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+    }
+  }
+`
+
+function mapItem(item: Record<string, unknown>): ChangelogItem {
+  return {
+    id: item.id as string,
+    product: item.productType === 'PlatformCore' ? 'Platform Core' : item.productType as string,
+    version: item.version as string,
+    versionType: item.versionType as ChangelogItem['versionType'],
+    title: item.title as string,
+    date: String(item.releaseDate).split('T')[0],
+    githubUrl: item.githubUrl as string,
+    body: item.body as string,
+    breaking: item.breaking as boolean,
+    narrative: {
+      summary: item.narrativeSummary as string,
+      impact: item.narrativeImpact as string,
+      details: item.narrativeDetails as string[],
+      migration: item.narrativeMigration as string | null,
+    },
+    createdAt: item.createdAt as string,
+    updatedAt: item.updatedAt as string | undefined,
+  }
+}
+
+async function fetchPage(after: string | null): Promise<{ edges: { node: Record<string, unknown> }[]; pageInfo: { hasNextPage: boolean; endCursor: string } }> {
+  const res = await fetch(ENDPOINT, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ query: QUERY(PAGE_SIZE, after) }),
+  })
+  const json = await res.json() as {
+    data?: { releases: { edges: { node: Record<string, unknown> }[]; pageInfo: { hasNextPage: boolean; endCursor: string } } }
+    errors?: { message: string }[]
+  }
+  if (json.errors?.length) throw new Error(json.errors[0].message)
+  return json.data!.releases
+}
+
+export default {
+  async load(): Promise<ChangelogData> {
+    const allItems: Record<string, unknown>[] = []
+    let cursor: string | null = null
+    while (true) {
+      const { edges, pageInfo } = await fetchPage(cursor)
+      allItems.push(...edges.map((e) => e.node))
+      if (!pageInfo.hasNextPage) break
+      cursor = pageInfo.endCursor
+    }
+    const entries = allItems
+      .map(mapItem)
+      .sort((a, b) => b.date.localeCompare(a.date))
+    return {
+      lastUpdated: new Date().toISOString(),
+      entries,
+    }
+  },
+}
diff --git a/scripts/merge-narratives.js b/scripts/merge-narratives.js
new file mode 100644
index 0000000..37e1ffa
--- /dev/null
+++ b/scripts/merge-narratives.js
@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+/**
+ * Merge narratives.json into data.json without duplicates
+ *
+ * Usage: node scripts/merge-narratives.js
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+
+async function main() {
+  const dataPath = path.join(process.cwd(), 'docs/reference/changelog/data.json');
+  const narrativesPath = path.join(process.cwd(), 'docs/reference/changelog/narratives.json');
+
+  // Load data.json
+  const dataContent = await fs.readFile(dataPath, 'utf-8');
+  const data = JSON.parse(dataContent);
+  console.log(`📊 Loaded ${data.entries.length} entries from data.json`);
+
+  // Load narratives.json
+  const narrativesContent = await fs.readFile(narrativesPath, 'utf-8');
+  const narratives = JSON.parse(narrativesContent);
+  console.log(`📝 Loaded ${narratives.releases.length} narratives from narratives.json`);
+
+  // Create ID map for quick lookup
+  const narrativeMap = new Map(
+    narratives.releases.map(r => [r.id, r.narrative])
+  );
+
+  // Merge narratives into data.json entries
+  let updatedCount = 0;
+  data.entries.forEach(entry => {
+    if (narrativeMap.has(entry.id)) {
+      entry.narrative = narrativeMap.get(entry.id);
+      updatedCount++;
+    }
+  });
+
+  // Update metadata
+  data.lastUpdated = new Date().toISOString();
+
+  // Write back
+  await fs.writeFile(dataPath, JSON.stringify(data, null, 2));
+
+  const withNarratives = data.entries.filter(e => e.narrative).length;
+
+  console.log('\n✅ Merge complete!');
+  console.log(`   Updated: ${updatedCount} entries`);
+  console.log(`   Total entries: ${data.entries.length}`);
+  console.log(`   With narratives: ${withNarratives}`);
+}
+
+main().catch(error => {
+  console.error('❌ Merge failed:', error);
+  process.exit(1);
+});
diff --git a/tsconfig.json b/tsconfig.json
index 06d8b4a..7800638 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -13,5 +13,5 @@
       "@/*": ["./.vitepress/*"]
     }
   },
-  "include": [".vitepress/**/*.ts", ".vitepress/**/*.vue", ".vitepress/env.d.ts"]
+  "include": [".vitepress/**/*.ts", ".vitepress/**/*.vue", ".vitepress/env.d.ts", "docs/**/*.data.ts"]
 }