@astro-minimax/ai 0.7.1 → 0.7.3

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"}