@astro-minimax/ai 0.7.1 → 0.7.2

package/dist/data/index.d.ts

@@ -1,3 +1,4 @@
 export { preloadMetadata, clearMetadataCache, getMetadata, getArticleSummary, getAllSummaries, getAuthorContext, getVoiceProfile, } from './metadata-loader.js';
 export type { AISummariesFile, AuthorContextFile, VoiceProfile, LoadedMetadata, ArticleSummaryData, AuthorPost, } from './types.js';
+export type { FactRegistryFile } from '../fact-registry/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/data/metadata-loader.d.ts

@@ -5,11 +5,11 @@ import type { AuthorContextFile, VoiceProfile, LoadedMetadata, ArticleSummaryDat
  *
  * Example (in functions/lib/ai.ts):
  *   import summaries from '../../datas/ai-summaries.json' with { type: 'json' };
- *   preloadMetadata({ summaries, authorContext, voiceProfile });
+ *   preloadMetadata({ summaries, authorContext, voiceProfile, factRegistry });
  */
 export declare function preloadMetadata(data: Partial<LoadedMetadata>): void;
 /**
- * Clears the metadata cache (useful for testing).
+ * Clears the metadata cache and all associated sub-caches (useful for testing).
  */
 export declare function clearMetadataCache(): void;
 /**

package/dist/data/metadata-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-loader.d.ts","sourceRoot":"","sources":["../../src/data/metadata-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKvH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAMnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAE5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE9E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD"}
+{"version":3,"file":"metadata-loader.d.ts","sourceRoot":"","sources":["../../src/data/metadata-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQvH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAgBnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAE5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE9E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD"}

package/dist/data/metadata-loader.js

@@ -1,3 +1,5 @@
+import { loadFactRegistry as loadFactRegistryCache } from '../fact-registry/registry.js';
+import { loadVectorIndex as loadVectorIndexCache } from '../search/vector-reranker.js';
 // Lazy-loaded, memory-cached metadata
 let cachedMetadata = null;
 /**
@@ -6,26 +8,36 @@ let cachedMetadata = null;
  *
  * Example (in functions/lib/ai.ts):
  *   import summaries from '../../datas/ai-summaries.json' with { type: 'json' };
- *   preloadMetadata({ summaries, authorContext, voiceProfile });
+ *   preloadMetadata({ summaries, authorContext, voiceProfile, factRegistry });
  */
 export function preloadMetadata(data) {
     cachedMetadata = {
         summaries: data.summaries ?? null,
         authorContext: data.authorContext ?? null,
         voiceProfile: data.voiceProfile ?? null,
+        factRegistry: data.factRegistry ?? null,
+        vectorIndex: data.vectorIndex ?? null,
     };
+    if (cachedMetadata.factRegistry) {
+        loadFactRegistryCache(cachedMetadata.factRegistry);
+    }
+    if (cachedMetadata.vectorIndex) {
+        loadVectorIndexCache(cachedMetadata.vectorIndex);
+    }
 }
 /**
- * Clears the metadata cache (useful for testing).
+ * Clears the metadata cache and all associated sub-caches (useful for testing).
  */
 export function clearMetadataCache() {
     cachedMetadata = null;
+    loadFactRegistryCache(null);
+    loadVectorIndexCache(null);
 }
 /**
  * Returns the cached metadata. Must call preloadMetadata() first.
  */
 export function getMetadata() {
-    return cachedMetadata ?? { summaries: null, authorContext: null, voiceProfile: null };
+    return cachedMetadata ?? { summaries: null, authorContext: null, voiceProfile: null, factRegistry: null, vectorIndex: null };
 }
 /**
  * Returns the AI-generated summary for an article by its slug.

package/dist/data/types.d.ts

@@ -47,5 +47,7 @@ export interface LoadedMetadata {
     summaries: AISummariesFile | null;
     authorContext: AuthorContextFile | null;
     voiceProfile: VoiceProfile | null;
+    factRegistry: import('../fact-registry/types.js').FactRegistryFile | null;
+    vectorIndex: import('../search/vector-reranker.js').VectorIndex | null;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/data/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,OAAO,2BAA2B,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1E,WAAW,EAAE,OAAO,8BAA8B,EAAE,WAAW,GAAG,IAAI,CAAC;CACxE"}

package/dist/fact-registry/fact-matcher.d.ts

@@ -0,0 +1,12 @@
+import type { Fact } from './types.js';
+/**
+ * Selects facts most relevant to the user's query.
+ *
+ * Strategy:
+ * 1. Always include very-high-confidence core facts (confidence >= 0.95)
+ * 2. Add category-matched facts based on query keywords
+ * 3. Add tag-matched facts for more specific queries
+ * 4. Deduplicate and cap total count
+ */
+export declare function matchFactsToQuery(query: string, lang?: string, maxFacts?: number): Fact[];
+//# sourceMappingURL=fact-matcher.d.ts.map

package/dist/fact-registry/fact-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-matcher.d.ts","sourceRoot":"","sources":["../../src/fact-registry/fact-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAC;AAwDrD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,SAAK,GACZ,IAAI,EAAE,CA2CR"}

package/dist/fact-registry/fact-matcher.js

@@ -0,0 +1,94 @@
+import { queryFacts } from './registry.js';
+/**
+ * Category detection keywords — when any keyword appears in the user query,
+ * the corresponding fact category is considered relevant.
+ */
+const CATEGORY_KEYWORDS = {
+    author: [
+        '作者', '博主', '谁', '关于我', '自我介绍', '个人',
+        'author', 'who', 'about me', 'introduce',
+    ],
+    blog: [
+        '博客', '文章', '多少', '数量', '统计', '总共', '分类', '标签', '语言',
+        'blog', 'post', 'how many', 'count', 'statistic', 'category', 'tag',
+    ],
+    content: [
+        '写过', '提到', '讨论', '观点', '主题', '话题', '涵盖', '领域',
+        'wrote', 'mention', 'discuss', 'topic', 'cover', 'area', 'opinion',
+    ],
+    project: [
+        '项目', '开源', '仓库', '工具', '产品',
+        'project', 'open source', 'repo', 'github', 'tool', 'product',
+    ],
+    tech: [
+        '技术', '技术栈', '框架', '库', '编程语言', '前端', '后端',
+        'tech', 'stack', 'framework', 'library', 'language', 'frontend', 'backend',
+    ],
+};
+/**
+ * Detect which fact categories are relevant to the user query.
+ */
+function detectRelevantCategories(query) {
+    const q = query.toLowerCase();
+    const matched = [];
+    for (const [category, keywords] of Object.entries(CATEGORY_KEYWORDS)) {
+        if (keywords.some(kw => q.includes(kw))) {
+            matched.push(category);
+        }
+    }
+    return matched;
+}
+/**
+ * Extract potential matching tags from the query by splitting into tokens.
+ */
+function extractQueryTags(query) {
+    const tokens = query.match(/[A-Za-z][A-Za-z0-9.+#-]{1,}|[\u4e00-\u9fa5]{2,6}/g);
+    return tokens?.map(t => t.toLowerCase()) ?? [];
+}
+/**
+ * Selects facts most relevant to the user's query.
+ *
+ * Strategy:
+ * 1. Always include very-high-confidence core facts (confidence >= 0.95)
+ * 2. Add category-matched facts based on query keywords
+ * 3. Add tag-matched facts for more specific queries
+ * 4. Deduplicate and cap total count
+ */
+export function matchFactsToQuery(query, lang, maxFacts = 15) {
+    const categories = detectRelevantCategories(query);
+    const queryTags = extractQueryTags(query);
+    // Layer 1: always-present core facts (highest confidence)
+    const coreFacts = queryFacts({
+        minConfidence: 0.95,
+        lang,
+        limit: 5,
+    });
+    // Layer 2: category-matched facts
+    const categoryFacts = categories.length > 0
+        ? queryFacts({
+            categories,
+            minConfidence: 0.7,
+            lang,
+            limit: 10,
+        })
+        : [];
+    // Layer 3: tag-matched facts (for specificity)
+    const tagFacts = queryTags.length > 0
+        ? queryFacts({
+            tags: queryTags,
+            minConfidence: 0.6,
+            lang,
+            limit: 5,
+        })
+        : [];
+    // Merge with deduplication, preserving priority order
+    const seen = new Set();
+    const result = [];
+    for (const fact of [...categoryFacts, ...tagFacts, ...coreFacts]) {
+        if (!seen.has(fact.id)) {
+            seen.add(fact.id);
+            result.push(fact);
+        }
+    }
+    return result.slice(0, maxFacts);
+}

package/dist/fact-registry/index.d.ts

@@ -0,0 +1,5 @@
+export { loadFactRegistry, clearFactRegistry, getFactRegistry, queryFacts, } from './registry.js';
+export { matchFactsToQuery } from './fact-matcher.js';
+export { buildFactSection } from './prompt-injector.js';
+export type { Fact, FactCategory, FactSource, FactRegistryFile, FactRegistryStats, FactQueryOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fact-registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fact-registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/fact-registry/index.js

@@ -0,0 +1,3 @@
+export { loadFactRegistry, clearFactRegistry, getFactRegistry, queryFacts, } from './registry.js';
+export { matchFactsToQuery } from './fact-matcher.js';
+export { buildFactSection } from './prompt-injector.js';

package/dist/fact-registry/prompt-injector.d.ts

@@ -0,0 +1,7 @@
+import type { Fact } from './types.js';
+/**
+ * Formats matched facts into a prompt section ready for injection.
+ * Groups facts by category with clear structure.
+ */
+export declare function buildFactSection(facts: Fact[], lang?: string): string;
+//# sourceMappingURL=prompt-injector.d.ts.map

package/dist/fact-registry/prompt-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-injector.d.ts","sourceRoot":"","sources":["../../src/fact-registry/prompt-injector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAC;AAgCrD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,GAAE,MAAa,GAAG,MAAM,CA+B3E"}

package/dist/fact-registry/prompt-injector.js

@@ -0,0 +1,57 @@
+const CATEGORY_LABELS = {
+    zh: {
+        author: '关于作者',
+        blog: '博客数据',
+        content: '内容事实',
+        project: '项目信息',
+        tech: '技术相关',
+    },
+    en: {
+        author: 'About the Author',
+        blog: 'Blog Statistics',
+        content: 'Content Facts',
+        project: 'Project Info',
+        tech: 'Tech Related',
+    },
+};
+const SECTION_TEXT = {
+    zh: {
+        title: '已验证事实（基于博客真实数据）',
+        instruction: '以上事实来自博客的真实数据。回答时优先使用这些已验证的事实，不要编造与之矛盾的信息。如果某个问题的答案不在已验证事实中，请如实说明。',
+    },
+    en: {
+        title: 'Verified Facts (based on real blog data)',
+        instruction: 'The above facts are derived from real blog data. Prioritize these verified facts when answering. Do not fabricate information that contradicts them. If the answer is not among verified facts, state that honestly.',
+    },
+};
+/**
+ * Formats matched facts into a prompt section ready for injection.
+ * Groups facts by category with clear structure.
+ */
+export function buildFactSection(facts, lang = 'zh') {
+    if (!facts.length)
+        return '';
+    const l = lang === 'zh' ? 'zh' : 'en';
+    const labels = CATEGORY_LABELS[l];
+    const text = SECTION_TEXT[l];
+    // Group by category
+    const grouped = new Map();
+    for (const fact of facts) {
+        const group = grouped.get(fact.category) ?? [];
+        group.push(fact);
+        grouped.set(fact.category, group);
+    }
+    const lines = [];
+    lines.push(`## ${text.title}`);
+    for (const [category, categoryFacts] of grouped) {
+        const label = labels[category] ?? category;
+        lines.push('');
+        lines.push(`### ${label}`);
+        for (const fact of categoryFacts) {
+            lines.push(`- ${fact.statement}`);
+        }
+    }
+    lines.push('');
+    lines.push(`> ${text.instruction}`);
+    return lines.join('\n');
+}

package/dist/fact-registry/registry.d.ts

@@ -0,0 +1,10 @@
+import type { Fact, FactRegistryFile, FactQueryOptions } from './types.js';
+export declare function loadFactRegistry(data: FactRegistryFile | null): void;
+export declare function clearFactRegistry(): void;
+export declare function getFactRegistry(): FactRegistryFile | null;
+/**
+ * Query facts with optional filters.
+ * Returns facts sorted by confidence (highest first).
+ */
+export declare function queryFacts(options?: FactQueryOptions): Fact[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/fact-registry/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/fact-registry/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAEpE;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,eAAe,IAAI,gBAAgB,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,EAAE,CAgCjE"}

package/dist/fact-registry/registry.js

@@ -0,0 +1,38 @@
+let cachedRegistry = null;
+export function loadFactRegistry(data) {
+    cachedRegistry = data;
+}
+export function clearFactRegistry() {
+    cachedRegistry = null;
+}
+export function getFactRegistry() {
+    return cachedRegistry;
+}
+/**
+ * Query facts with optional filters.
+ * Returns facts sorted by confidence (highest first).
+ */
+export function queryFacts(options = {}) {
+    if (!cachedRegistry?.facts.length)
+        return [];
+    let facts = cachedRegistry.facts;
+    if (options.categories?.length) {
+        const cats = new Set(options.categories);
+        facts = facts.filter(f => cats.has(f.category));
+    }
+    if (options.lang) {
+        facts = facts.filter(f => f.lang === options.lang || f.lang === 'all');
+    }
+    if (options.minConfidence !== undefined) {
+        facts = facts.filter(f => f.confidence >= options.minConfidence);
+    }
+    if (options.tags?.length) {
+        const tagSet = new Set(options.tags.map(t => t.toLowerCase()));
+        facts = facts.filter(f => f.tags.some(t => tagSet.has(t.toLowerCase())));
+    }
+    facts = [...facts].sort((a, b) => b.confidence - a.confidence);
+    if (options.limit && options.limit > 0) {
+        facts = facts.slice(0, options.limit);
+    }
+    return facts;
+}

package/dist/fact-registry/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Fact Registry — structured, verifiable facts extracted from blog data.
+ * Injected into prompts to ground AI responses in real data and reduce hallucination.
+ */
+export type FactCategory = 'author' | 'blog' | 'content' | 'project' | 'tech';
+/**
+ * How the fact was produced:
+ * - `explicit`: directly stated in blog content or configuration
+ * - `derived`: computed from blog data (counts, aggregations)
+ * - `aggregated`: synthesized from multiple posts/sources
+ */
+export type FactSource = 'explicit' | 'derived' | 'aggregated';
+export interface Fact {
+    id: string;
+    category: FactCategory;
+    /** Human-readable statement in the target language */
+    statement: string;
+    /** Where this fact comes from (file, config, computation) */
+    evidence: string;
+    source: FactSource;
+    /** 0–1 reliability score; 1 = absolute certainty */
+    confidence: number;
+    /** Keywords for query matching */
+    tags: string[];
+    lang: string;
+}
+export interface FactRegistryFile {
+    $schema: string;
+    generatedAt: string;
+    version: number;
+    facts: Fact[];
+    stats: FactRegistryStats;
+}
+export interface FactRegistryStats {
+    total: number;
+    byCategory: Record<FactCategory, number>;
+    avgConfidence: number;
+}
+export interface FactQueryOptions {
+    categories?: FactCategory[];
+    tags?: string[];
+    minConfidence?: number;
+    lang?: string;
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/fact-registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fact-registry/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAE/D,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/fact-registry/types.js

@@ -0,0 +1,5 @@
+/**
+ * Fact Registry — structured, verifiable facts extracted from blog data.
+ * Injected into prompts to ground AI responses in real data and reduce hallucination.
+ */
+export {};

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export * from './search/index.js';
 export * from './intelligence/index.js';
 export * from './prompt/index.js';
 export * from './data/index.js';
+export * from './fact-registry/index.js';
 export * from './stream/index.js';
 export * from './server/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,sBAAsB,CAAC;AAGrC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,sBAAsB,CAAC;AAGrC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -22,6 +22,8 @@ export * from './intelligence/index.js';
 export * from './prompt/index.js';
 // Build-time metadata loading
 export * from './data/index.js';
+// Fact Registry: verified facts for hallucination reduction
+export * from './fact-registry/index.js';
 // Stream utilities
 export * from './stream/index.js';
 // Server-side API handlers (chat handler, metadata init)

package/dist/prompt/dynamic-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-layer.d.ts","sourceRoot":"","sources":["../../src/prompt/dynamic-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwBrD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA0CpE"}
+{"version":3,"file":"dynamic-layer.d.ts","sourceRoot":"","sources":["../../src/prompt/dynamic-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwBrD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA+CpE"}

package/dist/prompt/dynamic-layer.js

@@ -24,10 +24,10 @@ const LABELS = {
  * Built fresh on every chat request.
  */
 export function buildDynamicLayer(config) {
-    const { userQuery, articles, projects, evidenceSection } = config;
+    const { userQuery, articles, projects, evidenceSection, factSection } = config;
     const lang = getLang(config.lang);
     const l = LABELS[lang];
-    if (!articles.length && !projects.length)
+    if (!articles.length && !projects.length && !factSection)
         return '';
     const lines = [];
     lines.push(`## ${l.relatedContent}`);
@@ -54,6 +54,10 @@ export function buildDynamicLayer(config) {
         }
         lines.push('');
     }
+    if (factSection) {
+        lines.push(factSection);
+        lines.push('');
+    }
     if (evidenceSection) {
         lines.push(evidenceSection);
     }

package/dist/prompt/types.d.ts

@@ -17,6 +17,8 @@ export interface DynamicLayerConfig {
     articles: ArticleContext[];
     projects: ProjectContext[];
     evidenceSection?: string;
+    /** Pre-built verified-facts prompt section from Fact Registry */
+    factSection?: string;
     lang?: string;
 }
 export interface PromptBuildConfig {

package/dist/prompt/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompt/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,qBAAqB,CAAC;IAClC,OAAO,EAAE,kBAAkB,CAAC;CAC7B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompt/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,qBAAqB,CAAC;IAClC,OAAO,EAAE,kBAAkB,CAAC;CAC7B"}

package/dist/search/idf.d.ts

@@ -0,0 +1,18 @@
+import type { IndexedDocument } from './types.js';
+export interface IDFMap {
+    /** term → IDF score (log-scaled) */
+    weights: Map<string, number>;
+    /** Total document count used for IDF computation */
+    docCount: number;
+}
+/**
+ * Builds an IDF (Inverse Document Frequency) map from indexed documents.
+ * Terms appearing in many documents get lower scores; rare terms get higher scores.
+ */
+export declare function buildIDFMap(documents: IndexedDocument[]): IDFMap;
+/**
+ * Returns the IDF weight for a token. Defaults to a high value for unknown
+ * tokens (they are very rare, so should score higher than average).
+ */
+export declare function getIDFWeight(idfMap: IDFMap | null, token: string): number;
+//# sourceMappingURL=idf.d.ts.map

package/dist/search/idf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idf.d.ts","sourceRoot":"","sources":["../../src/search/idf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,MAAM;IACrB,oCAAoC;IACpC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,MAAM,CAmBhE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzE"}

package/dist/search/idf.js

@@ -0,0 +1,31 @@
+/**
+ * Builds an IDF (Inverse Document Frequency) map from indexed documents.
+ * Terms appearing in many documents get lower scores; rare terms get higher scores.
+ */
+export function buildIDFMap(documents) {
+    const N = documents.length;
+    if (N === 0)
+        return { weights: new Map(), docCount: 0 };
+    const df = new Map();
+    for (const doc of documents) {
+        const uniqueTokens = new Set(doc.tokens);
+        for (const token of uniqueTokens) {
+            df.set(token, (df.get(token) || 0) + 1);
+        }
+    }
+    const weights = new Map();
+    for (const [term, count] of df) {
+        // Smooth IDF: log(N / (df + 1)) + 1 — ensures all terms have positive weight
+        weights.set(term, Math.log(N / (count + 1)) + 1);
+    }
+    return { weights, docCount: N };
+}
+/**
+ * Returns the IDF weight for a token. Defaults to a high value for unknown
+ * tokens (they are very rare, so should score higher than average).
+ */
+export function getIDFWeight(idfMap, token) {
+    if (!idfMap)
+        return 1;
+    return idfMap.weights.get(token) ?? Math.log(idfMap.docCount + 1) + 1;
+}

package/dist/search/index.d.ts

@@ -1,5 +1,10 @@
 export { initArticleIndex, initProjectIndex, searchArticles, searchProjects, mergeResults } from './search-api.js';
+export { getIDFMapForIndex } from './search-index.js';
+export { loadVectorIndex, clearVectorIndex, hasVectorIndex, rerankWithVectors } from './vector-reranker.js';
+export type { VectorIndex, VectorChunk } from './vector-reranker.js';
 export { getSessionCacheKey, getCachedContext, setCachedContext, deleteCachedContext, setCacheAdapter, getCacheAdapter, cleanupCache, SESSION_CACHE_TTL_SECONDS, SESSION_CACHE_TTL_MS, getCachedContextSync, setCachedContextSync, cleanupCacheLegacy, } from './session-cache.js';
 export { normalizeText, tokenize, scoreDocument } from './search-utils.js';
+export { buildIDFMap, getIDFWeight } from './idf.js';
+export type { IDFMap } from './idf.js';
 export type { SearchDocument, ArticleContext, ProjectContext, CachedSearchContext, SearchResult } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/search/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5G,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/search/index.js

@@ -1,3 +1,6 @@
 export { initArticleIndex, initProjectIndex, searchArticles, searchProjects, mergeResults } from './search-api.js';
+export { getIDFMapForIndex } from './search-index.js';
+export { loadVectorIndex, clearVectorIndex, hasVectorIndex, rerankWithVectors } from './vector-reranker.js';
 export { getSessionCacheKey, getCachedContext, setCachedContext, deleteCachedContext, setCacheAdapter, getCacheAdapter, cleanupCache, SESSION_CACHE_TTL_SECONDS, SESSION_CACHE_TTL_MS, getCachedContextSync, setCachedContextSync, cleanupCacheLegacy, } from './session-cache.js';
 export { normalizeText, tokenize, scoreDocument } from './search-utils.js';
+export { buildIDFMap, getIDFWeight } from './idf.js';

package/dist/search/search-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-api.d.ts","sourceRoot":"","sources":["../../src/search/search-api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAiC,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYhH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAElE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAElE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,cAAc,EAAE,CAsClB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,cAAc,EAAE,CAgBlB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAUzF"}
+{"version":3,"file":"search-api.d.ts","sourceRoot":"","sources":["../../src/search/search-api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAiC,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYhH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAElE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAElE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,cAAc,EAAE,CA6ClB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,cAAc,EAAE,CAgBlB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAUzF"}

package/dist/search/search-api.js

@@ -1,5 +1,6 @@
 import { scoreDocument, filterLowRelevance, tokenize, pickAnchorTerms, normalizeText } from './search-utils.js';
-import { buildSearchIndex } from './search-index.js';
+import { buildSearchIndex, getIDFMapForIndex } from './search-index.js';
+import { hasVectorIndex, rerankWithVectors } from './vector-reranker.js';
 // Lazy-initialized, cached indexes
 let articleIndex = null;
 let projectIndex = null;
@@ -38,7 +39,7 @@ export function searchArticles(query, options = {}) {
     const isDeepHit = options.enableDeepContent &&
         topScore >= DEEP_CONTENT_SCORE_THRESHOLD &&
         topScore > secondScore * 1.5;
-    return results.map((result, index) => {
+    let articles = results.map((result, index) => {
         const baseUrl = options.siteUrl ?? '';
         const url = result.url.startsWith('http') ? result.url : `${baseUrl}${result.url}`;
         const fullContent = isDeepHit && index === 0 && result.content
@@ -55,6 +56,11 @@ export function searchArticles(query, options = {}) {
             score: result.score,
         };
     });
+    // Optional: rerank using TF-IDF vector cosine similarity
+    if (hasVectorIndex() && articles.length > 1) {
+        articles = rerankWithVectors(query, articles);
+    }
+    return articles;
 }
 /**
  * Searches for projects related to the query.
@@ -92,8 +98,9 @@ export function mergeResults(primary, secondary) {
 }
 // ---- Internals ----
 function scoreDocs(index, tokens, limit) {
+    const idfMap = getIDFMapForIndex();
     return index
-        .map(doc => ({ ...doc, score: scoreDocument(tokens, doc) }))
+        .map(doc => ({ ...doc, score: scoreDocument(tokens, doc, idfMap) }))
         .filter(doc => doc.score > 0)
         .sort((a, b) => b.score - a.score)
         .slice(0, limit);

package/dist/search/search-index.d.ts

@@ -1,6 +1,12 @@
+import { type IDFMap } from './idf.js';
 import type { SearchDocument, IndexedDocument } from './types.js';
 /**
- * Builds an in-memory inverted index from a list of documents.
+ * Builds an in-memory inverted index from a list of documents
+ * and computes IDF weights across the corpus.
+ *
+ * IDF map is only updated when the document set is non-empty,
+ * preventing an empty index (e.g. projects) from wiping article IDF.
  */
 export declare function buildSearchIndex(documents: SearchDocument[]): IndexedDocument[];
+export declare function getIDFMapForIndex(): IDFMap | null;
 //# sourceMappingURL=search-index.d.ts.map

package/dist/search/search-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-index.d.ts","sourceRoot":"","sources":["../../src/search/search-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,eAAe,EAAE,CAK/E"}
+{"version":3,"file":"search-index.d.ts","sourceRoot":"","sources":["../../src/search/search-index.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,eAAe,EAAE,CAU/E;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjD"}

package/dist/search/search-index.js

@@ -1,12 +1,25 @@
 import { normalizeText } from './search-utils.js';
+import { buildIDFMap } from './idf.js';
+let cachedIDFMap = null;
 /**
- * Builds an in-memory inverted index from a list of documents.
+ * Builds an in-memory inverted index from a list of documents
+ * and computes IDF weights across the corpus.
+ *
+ * IDF map is only updated when the document set is non-empty,
+ * preventing an empty index (e.g. projects) from wiping article IDF.
  */
 export function buildSearchIndex(documents) {
-    return documents.map(doc => ({
+    const indexed = documents.map(doc => ({
         ...doc,
         tokens: buildDocumentTokens(doc),
     }));
+    if (indexed.length > 0) {
+        cachedIDFMap = buildIDFMap(indexed);
+    }
+    return indexed;
+}
+export function getIDFMapForIndex() {
+    return cachedIDFMap;
 }
 function buildDocumentTokens(doc) {
     const parts = [

package/dist/search/search-utils.d.ts

@@ -1,6 +1,7 @@
 /**
  * Text normalization and tokenization utilities for search.
  */
+import type { IDFMap } from './idf.js';
 /**
  * Normalizes text for search: lowercase, remove punctuation, normalize whitespace.
  */
@@ -14,8 +15,11 @@ export declare function tokenize(text: string): string[];
  */
 export declare function dedupeByContainment(terms: string[]): string[];
 /**
- * Computes a relevance score for a document against a set of query tokens.
- * Title matches score higher than content matches.
+ * Computes a relevance score for a document against query tokens.
+ *
+ * When an IDF map is provided, each token's contribution is weighted by its
+ * inverse document frequency — rare terms contribute more, common terms less.
+ * Falls back to uniform weighting when IDF is unavailable.
  */
 export declare function scoreDocument(tokens: string[], doc: {
     title: string;
@@ -24,7 +28,7 @@ export declare function scoreDocument(tokens: string[], doc: {
     keyPoints: string[];
     categories: string[];
     tags: string[];
-}): number;
+}, idfMap?: IDFMap | null): number;
 /**
  * Filters out low-relevance results relative to the top score.
  */

package/dist/search/search-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-utils.d.ts","sourceRoot":"","sources":["../../src/search/search-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAS7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CA2B3K;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC5D,OAAO,EAAE,CAAC,EAAE,EACZ,iBAAiB,SAAO,EACxB,gBAAgB,SAAI,GACnB,CAAC,EAAE,CAML;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAC/E,QAAQ,SAAI,EACZ,aAAa,SAAI,GAChB,MAAM,EAAE,CAuBV"}
+{"version":3,"file":"search-utils.d.ts","sourceRoot":"","sources":["../../src/search/search-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAS7D;AAYD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,EACnH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC5D,OAAO,EAAE,CAAC,EAAE,EACZ,iBAAiB,SAAO,EACxB,gBAAgB,SAAI,GACnB,CAAC,EAAE,CAML;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAC/E,QAAQ,SAAI,EACZ,aAAa,SAAI,GAChB,MAAM,EAAE,CAuBV"}

package/dist/search/search-utils.js

@@ -1,6 +1,7 @@
 /**
  * Text normalization and tokenization utilities for search.
  */
+import { getIDFWeight } from './idf.js';
 /**
  * Normalizes text for search: lowercase, remove punctuation, normalize whitespace.
  */
@@ -16,7 +17,6 @@ export function normalizeText(text) {
  */
 export function tokenize(text) {
     const normalized = normalizeText(text);
-    // Split on whitespace for multi-word queries
     const parts = normalized.split(/\s+/).filter(Boolean);
     return dedupeByContainment(parts);
 }
@@ -33,11 +33,23 @@ export function dedupeByContainment(terms) {
     }
     return kept;
 }
+/** Positional weight multipliers for each document field */
+const FIELD_WEIGHTS = {
+    title: 8,
+    keyPoints: 5,
+    categories: 4,
+    tags: 3,
+    excerpt: 3,
+    content: 1,
+};
 /**
- * Computes a relevance score for a document against a set of query tokens.
- * Title matches score higher than content matches.
+ * Computes a relevance score for a document against query tokens.
+ *
+ * When an IDF map is provided, each token's contribution is weighted by its
+ * inverse document frequency — rare terms contribute more, common terms less.
+ * Falls back to uniform weighting when IDF is unavailable.
  */
-export function scoreDocument(tokens, doc) {
+export function scoreDocument(tokens, doc, idfMap) {
     if (!tokens.length)
         return 0;
     let score = 0;
@@ -50,23 +62,19 @@ export function scoreDocument(tokens, doc) {
     for (const token of tokens) {
         if (!token)
             continue;
-        // Title: highest weight
+        const idf = getIDFWeight(idfMap ?? null, token);
         if (title.includes(token))
-            score += 8;
-        // KeyPoints: high weight
+            score += FIELD_WEIGHTS.title * idf;
         if (keyPointsText.includes(token))
-            score += 5;
-        // Categories/tags: medium weight
+            score += FIELD_WEIGHTS.keyPoints * idf;
         if (categoriesText.includes(token))
-            score += 4;
+            score += FIELD_WEIGHTS.categories * idf;
         if (tagsText.includes(token))
-            score += 3;
-        // Excerpt: medium weight
+            score += FIELD_WEIGHTS.tags * idf;
         if (excerpt.includes(token))
-            score += 3;
-        // Content sample: low weight
+            score += FIELD_WEIGHTS.excerpt * idf;
         if (contentSample.includes(token))
-            score += 1;
+            score += FIELD_WEIGHTS.content * idf;
     }
     return score;
 }

package/dist/search/vector-reranker.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Optional TF-IDF vector reranker.
+ *
+ * When a pre-built vector index is available (from `vectorize.ts`),
+ * uses cosine similarity to refine the ranking of search results.
+ * Gracefully degrades to a no-op when no vector index is loaded.
+ */
+import type { ArticleContext } from './types.js';
+export interface VectorChunk {
+    postId: string;
+    title: string;
+    lang: string;
+    chunkIndex: number;
+    text: string;
+    vector?: number[];
+}
+export interface VectorIndex {
+    version: number;
+    method: 'tfidf' | 'openai';
+    createdAt: string;
+    vocabulary?: string[];
+    chunks: VectorChunk[];
+}
+export declare function loadVectorIndex(data: VectorIndex | null): void;
+export declare function clearVectorIndex(): void;
+export declare function hasVectorIndex(): boolean;
+/**
+ * Reranks article search results using vector cosine similarity.
+ *
+ * For each candidate article, finds the best-matching chunk in the vector
+ * index and uses the cosine similarity as a reranking signal.
+ *
+ * Final score = original_score * (1 - alpha) + vector_score * alpha
+ *
+ * @param alpha - Blend factor (0 = ignore vectors, 1 = vectors only). Default 0.3
+ */
+export declare function rerankWithVectors<T extends Pick<ArticleContext, 'url' | 'score'>>(query: string, candidates: T[], alpha?: number): T[];
+//# sourceMappingURL=vector-reranker.d.ts.map

package/dist/search/vector-reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-reranker.d.ts","sourceRoot":"","sources":["../../src/search/vector-reranker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAOD,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAO9D;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,CAAC,EAC/E,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,EAAE,EACf,KAAK,SAAM,GACV,CAAC,EAAE,CAkCL"}

package/dist/search/vector-reranker.js

@@ -0,0 +1,135 @@
+/**
+ * Optional TF-IDF vector reranker.
+ *
+ * When a pre-built vector index is available (from `vectorize.ts`),
+ * uses cosine similarity to refine the ranking of search results.
+ * Gracefully degrades to a no-op when no vector index is loaded.
+ */
+// ── State ────────────────────────────────────────────────────
+let loadedIndex = null;
+let idfCache = null;
+export function loadVectorIndex(data) {
+    loadedIndex = data;
+    idfCache = null;
+    if (data?.vocabulary && data.chunks.length > 0) {
+        idfCache = buildIDFFromVocab(data.vocabulary, data.chunks);
+    }
+}
+export function clearVectorIndex() {
+    loadedIndex = null;
+    idfCache = null;
+}
+export function hasVectorIndex() {
+    return loadedIndex !== null && loadedIndex.chunks.length > 0;
+}
+// ── Core: Rerank ──────────────────────────────────────────────
+/**
+ * Reranks article search results using vector cosine similarity.
+ *
+ * For each candidate article, finds the best-matching chunk in the vector
+ * index and uses the cosine similarity as a reranking signal.
+ *
+ * Final score = original_score * (1 - alpha) + vector_score * alpha
+ *
+ * @param alpha - Blend factor (0 = ignore vectors, 1 = vectors only). Default 0.3
+ */
+export function rerankWithVectors(query, candidates, alpha = 0.3) {
+    if (!loadedIndex || !idfCache || !loadedIndex.vocabulary) {
+        return candidates;
+    }
+    const queryVector = computeQueryVector(query, loadedIndex.vocabulary, idfCache);
+    if (!queryVector)
+        return candidates;
+    // Map postId → best chunk cosine similarity
+    const articleScores = new Map();
+    for (const chunk of loadedIndex.chunks) {
+        if (!chunk.vector)
+            continue;
+        const sim = cosineSimilarity(queryVector, chunk.vector);
+        const current = articleScores.get(chunk.postId) ?? 0;
+        if (sim > current) {
+            articleScores.set(chunk.postId, sim);
+        }
+    }
+    if (articleScores.size === 0)
+        return candidates;
+    // Normalize original scores to 0-1
+    const maxOriginal = Math.max(...candidates.map(c => c.score ?? 0), 1);
+    const reranked = candidates.map(article => {
+        const slug = extractSlugFromUrl(article.url);
+        const vectorScore = articleScores.get(slug) ?? 0;
+        const originalNorm = (article.score ?? 0) / maxOriginal;
+        const blended = originalNorm * (1 - alpha) + vectorScore * alpha;
+        return { ...article, score: blended };
+    });
+    return reranked.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+}
+// ── Math Utilities ────────────────────────────────────────────
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dot = 0, magA = 0, magB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        magA += a[i] * a[i];
+        magB += b[i] * b[i];
+    }
+    const mag = Math.sqrt(magA) * Math.sqrt(magB);
+    return mag === 0 ? 0 : dot / mag;
+}
+function computeQueryVector(query, vocabulary, idf) {
+    const tokens = tokenizeForVector(query);
+    if (!tokens.length)
+        return null;
+    const tf = new Map();
+    for (const t of tokens)
+        tf.set(t, (tf.get(t) || 0) + 1);
+    const maxTf = Math.max(...tf.values(), 1);
+    const vector = vocabulary.map(term => {
+        const termTf = (tf.get(term) || 0) / maxTf;
+        const termIdf = idf.get(term) || 0;
+        return termTf * termIdf;
+    });
+    // Check if vector is all zeros
+    if (vector.every(v => v === 0))
+        return null;
+    return vector;
+}
+function tokenizeForVector(text) {
+    const CJK = /[\u4e00-\u9fff\u3400-\u4dbf]/g;
+    const cjkChars = text.match(CJK) || [];
+    const latin = text
+        .replace(CJK, ' ')
+        .toLowerCase()
+        .split(/\W+/)
+        .filter(w => w.length > 2);
+    return [...cjkChars, ...latin];
+}
+function buildIDFFromVocab(vocabulary, chunks) {
+    const N = chunks.length;
+    const df = new Map();
+    for (const chunk of chunks) {
+        const tokens = new Set(tokenizeForVector(chunk.text));
+        for (const term of vocabulary) {
+            if (tokens.has(term)) {
+                df.set(term, (df.get(term) || 0) + 1);
+            }
+        }
+    }
+    const idf = new Map();
+    for (const term of vocabulary) {
+        const docCount = df.get(term) || 0;
+        idf.set(term, Math.log(N / (docCount + 1)) + 1);
+    }
+    return idf;
+}
+/**
+ * Extracts a slug/postId from a URL path like "/zh/posts/some-slug/" → "zh/some-slug"
+ */
+function extractSlugFromUrl(url) {
+    const path = url.replace(/^https?:\/\/[^/]+/, '');
+    const match = path.match(/^\/([\w-]+)\/posts\/(.+?)\/?$/);
+    if (match)
+        return `${match[1]}/${match[2]}`;
+    return path.replace(/^\/|\/$/g, '');
+}

package/dist/server/chat-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../src/server/chat-handler.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,kBAAkB,EAAgC,MAAM,YAAY,CAAC;AA4HnF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0CtF"}
+{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../src/server/chat-handler.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,kBAAkB,EAAgC,MAAM,YAAY,CAAC;AA4HnF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0CtF"}

package/dist/server/chat-handler.js

@@ -1,6 +1,6 @@
 import { createUIMessageStream, createUIMessageStreamResponse, streamText, convertToModelMessages, } from 'ai';
 import { t, getLang } from '../utils/i18n.js';
-import { getClientIP, checkRateLimit, rateLimitResponse, searchArticles, searchProjects, getSessionCacheKey, getCachedContext, setCachedContext, shouldReuseSearchContext, buildLocalSearchQuery, shouldRunKeywordExtraction, extractSearchKeywords, KEYWORD_EXTRACTION_TIMEOUT_MS, shouldSkipAnalysis, analyzeRetrievedEvidence, buildEvidenceSection, EVIDENCE_ANALYSIS_TIMEOUT_MS, getCitationGuardPreflight, buildSystemPrompt, getAuthorContext, getVoiceProfile, mergeResults, getProviderManager, createCacheAdapter, detectPublicQuestion, getGlobalSearchCache, shouldAppendCitations, formatCitationBlock, selectCitations, setGlobalSearchCache, getGlobalCacheTTL, getResponseCache, setResponseCache, getResponseCacheConfig, rankArticlesByIntent, } from '../index.js';
+import { getClientIP, checkRateLimit, rateLimitResponse, searchArticles, searchProjects, getSessionCacheKey, getCachedContext, setCachedContext, shouldReuseSearchContext, buildLocalSearchQuery, shouldRunKeywordExtraction, extractSearchKeywords, KEYWORD_EXTRACTION_TIMEOUT_MS, shouldSkipAnalysis, analyzeRetrievedEvidence, buildEvidenceSection, EVIDENCE_ANALYSIS_TIMEOUT_MS, getCitationGuardPreflight, buildSystemPrompt, getAuthorContext, getVoiceProfile, mergeResults, getProviderManager, createCacheAdapter, detectPublicQuestion, getGlobalSearchCache, shouldAppendCitations, formatCitationBlock, selectCitations, setGlobalSearchCache, getGlobalCacheTTL, getResponseCache, setResponseCache, getResponseCacheConfig, rankArticlesByIntent, matchFactsToQuery, buildFactSection, } from '../index.js';
 import { createChatStatusData } from './types.js';
 import { errors, corsPreflightResponse } from './errors.js';
 import { notifyAiChat } from './notify.js';
@@ -187,10 +187,12 @@ async function runPipeline(args) {
                     let responseText = '';
                     if (adapter) {
                         const articlePrompt = buildArticleContextPrompt(context);
+                        const matchedFacts = matchFactsToQuery(cachedSearch.query, lang);
+                        const factPromptSection = buildFactSection(matchedFacts, lang);
                         const systemPrompt = buildSystemPrompt({
                             static: { authorName: env.SITE_AUTHOR || '博主', siteUrl: env.SITE_URL || '', lang },
                             semiStatic: { authorContext: getAuthorContext(), voiceProfile: getVoiceProfile() },
-                            dynamic: { userQuery: cachedSearch.query, articles: cachedSearch.articles, projects: cachedSearch.projects, evidenceSection: articlePrompt },
+                            dynamic: { userQuery: cachedSearch.query, articles: cachedSearch.articles, projects: cachedSearch.projects, evidenceSection: articlePrompt, factSection: factPromptSection },
                         });
                         const llmResult = await streamLLMResponse({ writer: w, adapter, systemPrompt, messages, lang });
                         responseText = llmResult.responseText;
@@ -326,6 +328,9 @@ async function runPipeline(args) {
         projects: relatedProjects,
         lang,
     });
+    // ── Fact Registry ───────────────────────────────────────────
+    const matchedFacts = matchFactsToQuery(latestText, lang);
+    const factPromptSection = buildFactSection(matchedFacts, lang);
     // ── Build System Prompt ─────────────────────────────────────
     const articlePrompt = buildArticleContextPrompt(context);
     const systemPrompt = buildSystemPrompt({
@@ -345,6 +350,7 @@ async function runPipeline(args) {
             evidenceSection: articlePrompt
                 ? `${evidenceSection}\n${articlePrompt}`
                 : evidenceSection,
+            factSection: factPromptSection,
             lang,
         },
     });

package/dist/server/metadata-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-init.d.ts","sourceRoot":"","sources":["../../src/server/metadata-init.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,CAoCrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"metadata-init.d.ts","sourceRoot":"","sources":["../../src/server/metadata-init.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,CAsCrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/server/metadata-init.js

@@ -12,6 +12,8 @@ export function initializeMetadata(config, env) {
         summaries: config.summaries,
         authorContext: config.authorContext,
         voiceProfile: config.voiceProfile,
+        factRegistry: (config.factRegistry ?? null),
+        vectorIndex: (config.vectorIndex ?? null),
     });
     const authorCtx = getAuthorContext();
     const allSummaries = getAllSummaries();

package/dist/server/types.d.ts

@@ -52,6 +52,8 @@ export interface MetadataConfig {
     summaries: unknown;
     authorContext: unknown;
     voiceProfile: unknown;
+    factRegistry?: unknown;
+    vectorIndex?: unknown;
     siteUrl?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB,EAAE,QAAQ;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACjD;AAID,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,cAAc,CAMhB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAIxE;AAID,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB,EAAE,QAAQ;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACjD;AAID,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,cAAc,CAMhB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAIxE;AAID,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astro-minimax/ai",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "type": "module",
   "description": "Vendor-agnostic AI integration package with full RAG pipeline for astro-minimax blogs — supports OpenAI, Cloudflare AI, and custom providers.",
   "author": "Souloss",
@@ -57,6 +57,10 @@
       "types": "./dist/data/index.d.ts",
       "import": "./dist/data/index.js"
     },
+    "./fact-registry": {
+      "types": "./dist/fact-registry/index.d.ts",
+      "import": "./dist/fact-registry/index.js"
+    },
     "./stream": {
       "types": "./dist/stream/index.d.ts",
       "import": "./dist/stream/index.js"
@@ -80,7 +84,7 @@
     "@ai-sdk/openai-compatible": "^2.0.35",
     "ai": "^6.0.116",
     "workers-ai-provider": "^3.1.2",
-    "@astro-minimax/notify": "0.7.1"
+    "@astro-minimax/notify": "0.7.2"
   },
   "optionalDependencies": {
     "undici": "^6.0.0"

package/src/components/AIChatWidget.astro

@@ -9,7 +9,7 @@ interface Props {
 }
 
 const { lang = SITE.lang ?? "zh", articleContext } = Astro.props;
-const aiEnabled = SITE.ai?.enabled ?? false;
+const aiEnabled = SITE.aiEnabled ?? false;
 
 const aiConfig = {
   enabled: aiEnabled,