feat: add topic alias resolution APIs

src/core/migrations.ts

@@ -3,6 +3,7 @@ import type { Kysely } from 'kysely';
 import {
   FACTS_TABLE,
   FACT_TOPICS_TABLE,
+  TOPIC_ALIASES_TABLE,
   TOPIC_RELATIONS_TABLE,
   TOPICS_TABLE,
 } from './schema';
@@ -67,6 +68,20 @@ export async function initializeSchema(
     .addPrimaryKeyConstraint('topic_relations_pk', ['parent_topic_id', 'child_topic_id', 'relation'])
     .execute();
 
+  await db.schema
+    .createTable(TOPIC_ALIASES_TABLE)
+    .ifNotExists()
+    .addColumn('id', 'text', (column) => column.primaryKey())
+    .addColumn('topic_id', 'text', (column) =>
+      column.notNull().references(`${TOPICS_TABLE}.id`).onDelete('cascade'),
+    )
+    .addColumn('alias', 'text', (column) => column.notNull())
+    .addColumn('normalized_alias', 'text', (column) => column.notNull().unique())
+    .addColumn('is_primary', 'integer', (column) => column.notNull())
+    .addColumn('created_at', 'text', (column) => column.notNull())
+    .addColumn('updated_at', 'text', (column) => column.notNull())
+    .execute();
+
   await db.schema
     .createIndex('fact_topics_topic_id_idx')
     .ifNotExists()
@@ -94,4 +109,11 @@ export async function initializeSchema(
     .on(TOPIC_RELATIONS_TABLE)
     .column('child_topic_id')
     .execute();
+
+  await db.schema
+    .createIndex('topic_aliases_topic_id_idx')
+    .ifNotExists()
+    .on(TOPIC_ALIASES_TABLE)
+    .column('topic_id')
+    .execute();
 }