stellavault 0.2.0 → 0.2.1

package/packages/core/dist/federation/sharing.js

@@ -0,0 +1,246 @@
+// Federation: Sharing Control v2 — Level-based sharing system
+// Level 0: 차단 (검색 안 됨)
+// Level 1: 제목 + 유사도만
+// Level 2: Level 1 + 50자 스니펫
+// Level 3: Level 2 + 요청 시 전문 (피어 승인)
+// Level 4: Level 3 + 전문 자동 공개
+//
+// 상호 매칭: 내 공개 레벨이 높을수록 남의 것도 더 많이 볼 수 있음
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+export const LEVEL_LABELS = {
+    0: 'Blocked (not searchable)',
+    1: 'Title + similarity only',
+    2: 'Title + snippet (50 chars)',
+    3: 'Full text on request (approval needed)',
+    4: 'Full text auto-shared',
+};
+export const LEVEL_ICONS = {
+    0: '🚫', 1: '📌', 2: '📝', 3: '📖', 4: '🌐',
+};
+// 크레딧 보너스 (레벨별)
+export const LEVEL_CREDIT_MULTIPLIER = {
+    0: 0, 1: 1, 2: 2, 3: 5, 4: 10,
+};
+const SHARING_FILE = join(homedir(), '.stellavault', 'federation', 'sharing.json');
+const SENSITIVE_PATTERNS = [
+    /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/,
+    /\b\d{3}[-.]?\d{4}[-.]?\d{4}\b/,
+    /\b(sk-|pk-|api[_-]?key|token|secret)[a-zA-Z0-9_-]{10,}\b/i,
+    /\bpassword\s*[:=]\s*\S+/i,
+    /\b\d{6}[-]\d{7}\b/,
+];
+const DEFAULT_CONFIG = {
+    defaultLevel: 2, // 기본: 스니펫까지
+    myNodeLevel: 2, // 내 노드 기본: 스니펫까지
+    rules: [
+        // 기본 규칙
+        { pattern: 'public', type: 'tag', level: 4 },
+        { pattern: 'opensource', type: 'tag', level: 4 },
+        { pattern: 'personal', type: 'tag', level: 1 },
+        { pattern: 'private', type: 'tag', level: 0 },
+        { pattern: 'secret', type: 'tag', level: 0 },
+        { pattern: 'diary', type: 'tag', level: 0 },
+        { pattern: 'salary', type: 'tag', level: 0 },
+        { pattern: 'password', type: 'tag', level: 0 },
+        { pattern: 'credential', type: 'tag', level: 0 },
+        { pattern: '03_Daily', type: 'folder', level: 1 },
+        { pattern: '06_Archive', type: 'folder', level: 1 },
+        { pattern: '.obsidian', type: 'folder', level: 0 },
+    ],
+    blockedDocIds: [],
+    blockSensitivePatterns: true,
+    pendingRequests: [],
+};
+export function loadSharingConfig() {
+    if (existsSync(SHARING_FILE)) {
+        const raw = JSON.parse(readFileSync(SHARING_FILE, 'utf-8'));
+        return { ...DEFAULT_CONFIG, ...raw };
+    }
+    return { ...DEFAULT_CONFIG };
+}
+export function saveSharingConfig(config) {
+    mkdirSync(join(homedir(), '.stellavault', 'federation'), { recursive: true });
+    writeFileSync(SHARING_FILE, JSON.stringify(config, null, 2), 'utf-8');
+}
+// 문서의 공유 레벨 결정
+export function getDocumentLevel(doc, config) {
+    const cfg = config ?? loadSharingConfig();
+    // 1. 개별 차단
+    if (cfg.blockedDocIds.includes(doc.id))
+        return 0;
+    // 2. 민감 패턴 감지 → Level 0
+    if (cfg.blockSensitivePatterns) {
+        for (const pattern of SENSITIVE_PATTERNS) {
+            if (pattern.test(doc.content))
+                return 0;
+        }
+    }
+    // 3. 규칙 매칭 (가장 구체적인 규칙 우선)
+    let matchedLevel = null;
+    // 문서ID 규칙 (가장 구체적)
+    for (const rule of cfg.rules) {
+        if (rule.type === 'doc' && rule.pattern === doc.id) {
+            return rule.level;
+        }
+    }
+    // 태그 규칙 (가장 제한적인 것 적용)
+    const docTags = doc.tags.map(t => t.toLowerCase());
+    for (const rule of cfg.rules) {
+        if (rule.type === 'tag' && docTags.includes(rule.pattern.toLowerCase())) {
+            if (matchedLevel === null || rule.level < matchedLevel) {
+                matchedLevel = rule.level;
+            }
+        }
+    }
+    // 폴더 규칙
+    for (const rule of cfg.rules) {
+        if (rule.type === 'folder' && doc.filePath.startsWith(rule.pattern)) {
+            if (matchedLevel === null || rule.level < matchedLevel) {
+                matchedLevel = rule.level;
+            }
+        }
+    }
+    return matchedLevel ?? cfg.defaultLevel;
+}
+// 이전 API 호환: isDocumentShareable = Level > 0
+export function isDocumentShareable(doc, config) {
+    return getDocumentLevel(doc, config) > 0;
+}
+// 상호 매칭: 내 레벨에 따라 상대 문서를 어디까지 볼 수 있는가
+export function getAccessibleLevel(myLevel, docLevel) {
+    // 내 공개 레벨이 상대 문서 레벨 이상이어야 열람 가능
+    // 단, 상대가 공개한 범위를 넘을 수는 없음
+    return Math.min(myLevel, docLevel);
+}
+export function buildLeveledResult(doc, similarity, requesterNodeLevel, config) {
+    const docLevel = getDocumentLevel(doc, config);
+    if (docLevel === 0)
+        return null; // 차단
+    const accessLevel = getAccessibleLevel(requesterNodeLevel, docLevel);
+    if (accessLevel === 0)
+        return null;
+    return {
+        title: accessLevel >= 1 ? doc.title : '[Hidden]',
+        similarity,
+        snippet: accessLevel >= 2 ? sanitizeSnippet(doc.content.slice(0, 50)) : undefined,
+        fullTextAvailable: docLevel >= 3,
+        autoShare: docLevel >= 4,
+        level: accessLevel,
+    };
+}
+// 전문 열람 요청
+export function createFullTextRequest(fromPeerId, fromName, documentId, documentTitle) {
+    const cfg = loadSharingConfig();
+    const request = {
+        requestId: `req-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        fromPeerId, fromName, documentTitle, documentId,
+        requestedAt: new Date().toISOString(),
+        status: 'pending',
+    };
+    cfg.pendingRequests.push(request);
+    // 최근 50개만 유지
+    if (cfg.pendingRequests.length > 50)
+        cfg.pendingRequests = cfg.pendingRequests.slice(-50);
+    saveSharingConfig(cfg);
+    return request;
+}
+export function approveRequest(requestId) {
+    const cfg = loadSharingConfig();
+    const req = cfg.pendingRequests.find(r => r.requestId === requestId);
+    if (!req)
+        return false;
+    req.status = 'approved';
+    saveSharingConfig(cfg);
+    return true;
+}
+export function denyRequest(requestId) {
+    const cfg = loadSharingConfig();
+    const req = cfg.pendingRequests.find(r => r.requestId === requestId);
+    if (!req)
+        return false;
+    req.status = 'denied';
+    saveSharingConfig(cfg);
+    return true;
+}
+export function getPendingRequests() {
+    return loadSharingConfig().pendingRequests.filter(r => r.status === 'pending');
+}
+// 스니펫 민감 정보 제거
+export function sanitizeSnippet(snippet) {
+    let safe = snippet;
+    for (const pattern of SENSITIVE_PATTERNS) {
+        safe = safe.replace(pattern, '[REDACTED]');
+    }
+    return safe;
+}
+// 규칙 관리 헬퍼
+export function setTagLevel(tag, level) {
+    const cfg = loadSharingConfig();
+    const existing = cfg.rules.findIndex(r => r.type === 'tag' && r.pattern.toLowerCase() === tag.toLowerCase());
+    if (existing >= 0)
+        cfg.rules[existing].level = level;
+    else
+        cfg.rules.push({ pattern: tag.toLowerCase(), type: 'tag', level });
+    saveSharingConfig(cfg);
+}
+export function setFolderLevel(folder, level) {
+    const cfg = loadSharingConfig();
+    const existing = cfg.rules.findIndex(r => r.type === 'folder' && r.pattern === folder);
+    if (existing >= 0)
+        cfg.rules[existing].level = level;
+    else
+        cfg.rules.push({ pattern: folder, type: 'folder', level });
+    saveSharingConfig(cfg);
+}
+export function setNodeLevel(level) {
+    const cfg = loadSharingConfig();
+    cfg.myNodeLevel = level;
+    saveSharingConfig(cfg);
+}
+export function setDefaultLevel(level) {
+    const cfg = loadSharingConfig();
+    cfg.defaultLevel = level;
+    saveSharingConfig(cfg);
+}
+// CLI 요약
+export function getSharingSummary(config) {
+    const cfg = config ?? loadSharingConfig();
+    const lines = [];
+    lines.push(`My Node Level: ${LEVEL_ICONS[cfg.myNodeLevel]} Level ${cfg.myNodeLevel} (${LEVEL_LABELS[cfg.myNodeLevel]})`);
+    lines.push(`Default Doc Level: ${LEVEL_ICONS[cfg.defaultLevel]} Level ${cfg.defaultLevel}`);
+    lines.push(`Credit Multiplier: ${LEVEL_CREDIT_MULTIPLIER[cfg.myNodeLevel]}x`);
+    lines.push('');
+    lines.push('Rules:');
+    for (const rule of cfg.rules) {
+        lines.push(`  ${LEVEL_ICONS[rule.level]} [${rule.type}] ${rule.pattern} → Level ${rule.level}`);
+    }
+    if (cfg.blockedDocIds.length > 0) {
+        lines.push(`  🚫 ${cfg.blockedDocIds.length} docs individually blocked`);
+    }
+    lines.push('');
+    const pending = cfg.pendingRequests.filter(r => r.status === 'pending');
+    if (pending.length > 0) {
+        lines.push(`📬 ${pending.length} pending full-text requests`);
+    }
+    lines.push(`Sensitive pattern filter: ${cfg.blockSensitivePatterns ? 'ON' : 'OFF'}`);
+    return lines.join('\n');
+}
+// 레거시 호환
+export function addBlockedTag(tag) { setTagLevel(tag, 0); }
+export function removeBlockedTag(tag) { setTagLevel(tag, 2); }
+export function addBlockedFolder(folder) { setFolderLevel(folder, 0); }
+export function blockDocument(docId) {
+    const cfg = loadSharingConfig();
+    if (!cfg.blockedDocIds.includes(docId)) {
+        cfg.blockedDocIds.push(docId);
+        saveSharingConfig(cfg);
+    }
+}
+export function unblockDocument(docId) {
+    const cfg = loadSharingConfig();
+    cfg.blockedDocIds = cfg.blockedDocIds.filter(id => id !== docId);
+    saveSharingConfig(cfg);
+}
+//# sourceMappingURL=sharing.js.map

package/packages/core/dist/federation/trust.d.ts

@@ -0,0 +1,15 @@
+export interface TrustEntry {
+    peerId: string;
+    displayName: string;
+    level: 'vouched' | 'neutral' | 'blocked';
+    reason?: string;
+    updatedAt: string;
+}
+export declare function vouch(peerId: string, displayName: string, reason?: string): TrustEntry;
+export declare function revoke(peerId: string): boolean;
+export declare function block(peerId: string, displayName: string, reason?: string): TrustEntry;
+export declare function getTrustLevel(peerId: string): TrustEntry['level'];
+export declare function isBlocked(peerId: string): boolean;
+export declare function listTrusted(): TrustEntry[];
+export declare function computeTrustScore(peerId: string): number;
+//# sourceMappingURL=trust.d.ts.map

package/packages/core/dist/federation/trust.js

@@ -0,0 +1,60 @@
+// Federation Phase 2: Web of Trust
+// vouch/revoke/block — 노드 간 상호 신뢰 관리
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const TRUST_FILE = join(homedir(), '.stellavault', 'federation', 'trust.json');
+function loadTrustDb() {
+    if (!existsSync(TRUST_FILE))
+        return new Map();
+    const raw = JSON.parse(readFileSync(TRUST_FILE, 'utf-8'));
+    return new Map(raw.map(e => [e.peerId, e]));
+}
+function saveTrustDb(db) {
+    mkdirSync(join(homedir(), '.stellavault', 'federation'), { recursive: true });
+    writeFileSync(TRUST_FILE, JSON.stringify([...db.values()], null, 2), 'utf-8');
+}
+export function vouch(peerId, displayName, reason) {
+    const db = loadTrustDb();
+    const entry = { peerId, displayName, level: 'vouched', reason, updatedAt: new Date().toISOString() };
+    db.set(peerId, entry);
+    saveTrustDb(db);
+    return entry;
+}
+export function revoke(peerId) {
+    const db = loadTrustDb();
+    const entry = db.get(peerId);
+    if (!entry)
+        return false;
+    entry.level = 'neutral';
+    entry.updatedAt = new Date().toISOString();
+    saveTrustDb(db);
+    return true;
+}
+export function block(peerId, displayName, reason) {
+    const db = loadTrustDb();
+    const entry = { peerId, displayName, level: 'blocked', reason, updatedAt: new Date().toISOString() };
+    db.set(peerId, entry);
+    saveTrustDb(db);
+    return entry;
+}
+export function getTrustLevel(peerId) {
+    const db = loadTrustDb();
+    return db.get(peerId)?.level ?? 'neutral';
+}
+export function isBlocked(peerId) {
+    return getTrustLevel(peerId) === 'blocked';
+}
+export function listTrusted() {
+    return [...loadTrustDb().values()];
+}
+// 신뢰 점수 계산 (0-100)
+export function computeTrustScore(peerId) {
+    const level = getTrustLevel(peerId);
+    switch (level) {
+        case 'vouched': return 80;
+        case 'neutral': return 50;
+        case 'blocked': return 0;
+    }
+}
+//# sourceMappingURL=trust.js.map

package/packages/core/dist/federation/types.d.ts

@@ -0,0 +1,40 @@
+export interface PeerInfo {
+    peerId: string;
+    displayName: string;
+    documentCount: number;
+    topTopics: string[];
+    joinedAt: string;
+    lastSeen: string;
+}
+export interface FederatedSearchResult {
+    title: string;
+    similarity: number;
+    snippet: string;
+    peerId: string;
+    peerName: string;
+}
+export type FederationMessage = {
+    type: 'handshake';
+    peerId: string;
+    displayName: string;
+    version: string;
+    documentCount: number;
+    topTopics: string[];
+} | {
+    type: 'search_query';
+    queryId: string;
+    embedding: number[];
+    limit: number;
+} | {
+    type: 'search_result';
+    queryId: string;
+    results: Array<{
+        title: string;
+        similarity: number;
+        snippet: string;
+    }>;
+} | {
+    type: 'leave';
+    peerId: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/packages/core/dist/federation/types.js

@@ -0,0 +1,3 @@
+// Design Ref: §2.2 — Federation 공유 타입 정의
+export {};
+//# sourceMappingURL=types.js.map

package/packages/core/dist/i18n/index.d.ts

@@ -0,0 +1,6 @@
+export type Locale = 'en' | 'ko' | 'ja' | 'zh';
+export declare function setLocale(locale: Locale): void;
+export declare function getLocale(): Locale;
+export declare function t(key: string, fallback?: string): string;
+export declare function detectLocale(): Locale;
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/i18n/index.js

@@ -0,0 +1,81 @@
+// i18n Foundation (F-A19)
+// Simple string externalization for CLI and Graph UI
+const strings = {
+    en: {
+        'init.welcome': 'Stellavault Setup Wizard',
+        'init.tagline': "Notes die in folders. Let's bring yours to life.",
+        'init.step1': 'Where is your Obsidian vault?',
+        'init.step2': 'Indexing your vault',
+        'init.step3': 'Try your first search',
+        'init.done': 'Setup complete!',
+        'index.complete': 'Indexing complete',
+        'search.no_results': 'No results found.',
+        'decay.report_title': 'Knowledge Decay Report',
+        'decay.tip': 'Search a topic to refresh decaying knowledge',
+        'learn.title': 'Your Learning Path',
+        'learn.all_clear': 'All clear! Your knowledge is in great shape.',
+        'contradictions.title': 'potential contradictions found',
+        'contradictions.none': 'No contradictions detected. Your knowledge is consistent!',
+        'graph.title': 'Stellavault',
+        'graph.subtitle': 'Neural Knowledge Graph',
+        'error.vault_not_found': 'Vault not found',
+        'error.db_init_failed': 'Database initialization failed',
+        'error.embedder_failed': 'Embedding model failed to load',
+    },
+    ko: {
+        'init.welcome': 'Stellavault 설정 마법사',
+        'init.tagline': '노트는 폴더에서 죽습니다. 당신의 지식을 살려봅시다.',
+        'init.step1': 'Obsidian vault 경로가 어디인가요?',
+        'init.step2': 'vault 인덱싱 중',
+        'init.step3': '첫 번째 검색을 해보세요',
+        'init.done': '설정 완료!',
+        'index.complete': '인덱싱 완료',
+        'search.no_results': '검색 결과가 없습니다.',
+        'decay.report_title': '지식 감쇠 리포트',
+        'decay.tip': '검색하면 감쇠 중인 지식이 리프레시됩니다',
+        'learn.title': '당신의 학습 경로',
+        'learn.all_clear': '모든 지식이 건강합니다!',
+        'contradictions.title': '개의 잠재적 모순 발견',
+        'contradictions.none': '모순이 없습니다. 지식이 일관됩니다!',
+        'graph.title': 'Stellavault',
+        'graph.subtitle': '뉴럴 지식 그래프',
+        'error.vault_not_found': 'vault를 찾을 수 없습니다',
+        'error.db_init_failed': '데이터베이스 초기화 실패',
+        'error.embedder_failed': '임베딩 모델 로딩 실패',
+    },
+    ja: {
+        'init.welcome': 'Stellavault セットアップウィザード',
+        'init.tagline': 'ノートはフォルダで死にます。あなたの知識を生かしましょう。',
+        'graph.title': 'Stellavault',
+        'graph.subtitle': 'ニューラルナレッジグラフ',
+        'search.no_results': '検索結果がありません。',
+    },
+    zh: {
+        'init.welcome': 'Stellavault 设置向导',
+        'init.tagline': '笔记在文件夹中消亡。让你的知识活起来。',
+        'graph.title': 'Stellavault',
+        'graph.subtitle': '神经知识图谱',
+        'search.no_results': '没有搜索结果。',
+    },
+};
+let currentLocale = 'en';
+export function setLocale(locale) {
+    currentLocale = locale;
+}
+export function getLocale() {
+    return currentLocale;
+}
+export function t(key, fallback) {
+    return strings[currentLocale]?.[key] ?? strings.en[key] ?? fallback ?? key;
+}
+export function detectLocale() {
+    const env = process.env.LANG || process.env.LANGUAGE || process.env.LC_ALL || '';
+    if (env.startsWith('ko'))
+        return 'ko';
+    if (env.startsWith('ja'))
+        return 'ja';
+    if (env.startsWith('zh'))
+        return 'zh';
+    return 'en';
+}
+//# sourceMappingURL=index.js.map

package/packages/core/{src/index.ts → dist/index.d.ts}

@@ -1,47 +1,21 @@
-// Design Ref: §4.2 — Core Internal API (Facade)
-// Design Ref: §9.3 — Dependency Injection Pattern
-
 export { loadConfig } from './config.js';
 export type { StellavaultConfig } from './config.js';
-
-// Types
 export type { Document } from './types/document.js';
 export type { Chunk, ScoredChunk } from './types/chunk.js';
-export type {
-  SearchResult,
-  SearchOptions,
-  TopicInfo,
-  StoreStats,
-} from './types/search.js';
-
-// Interfaces
+export type { SearchResult, SearchOptions, TopicInfo, StoreStats, } from './types/search.js';
 export type { VectorStore } from './store/types.js';
 export type { Embedder } from './indexer/embedder.js';
-
-// Store
 export { createSqliteVecStore } from './store/index.js';
-
-// Indexer
 export { indexVault, scanVault, chunkDocument, createLocalEmbedder } from './indexer/index.js';
 export type { IndexResult, IndexerOptions } from './indexer/index.js';
-
-// Search
 export { createSearchEngine } from './search/index.js';
 export type { SearchEngine } from './search/index.js';
-
-// MCP
 export { createMcpServer } from './mcp/index.js';
-
-// Pack (Phase 3)
 export { createPack, exportPack, importPack, packToSummary, maskPII } from './pack/index.js';
 export type { KnowledgePack, PackChunk, PackInfo, CreatePackOptions, ImportResult, MaskResult } from './pack/index.js';
-
-// API (Phase 2)
 export { createApiServer } from './api/server.js';
 export type { ApiServerOptions } from './api/server.js';
 export type { GraphNode, GraphEdge, Cluster, GraphData, GraphResponse } from './types/graph.js';
-
-// Intelligence (Phase 4b)
 export { DecayEngine } from './intelligence/decay-engine.js';
 export type { DecayState, AccessEvent, DecayReport } from './intelligence/types.js';
 export { computeRetrievability, updateStability, estimateInitialStability, elapsedDays } from './intelligence/fsrs.js';
@@ -58,35 +32,19 @@ export { generateLearningPath } from './intelligence/learning-path.js';
 export type { LearningPath, LearningItem, LearningPathInput } from './intelligence/learning-path.js';
 export { checkNotifications } from './intelligence/notifications.js';
 export type { Notification, NotificationConfig } from './intelligence/notifications.js';
-
-// Multi-Vault
 export { addVault, removeVault, listVaults, getVault, searchAllVaults } from './multi-vault/index.js';
 export type { VaultEntry, CrossVaultSearchResult } from './multi-vault/index.js';
-
-// Voice Capture
 export { captureVoice, transcribeAudio, isWhisperAvailable } from './capture/voice.js';
 export type { CaptureResult, CaptureOptions } from './capture/voice.js';
-
-// Dashboard + PWA
 export { mountDashboard } from './api/dashboard.js';
 export { mountPWA } from './api/pwa.js';
-
-// Agentic Graph
 export { createAgenticGraphTools } from './mcp/tools/agentic-graph.js';
-
-// Cloud
 export { syncToCloud, restoreFromCloud, getSyncState, encrypt, decrypt, getOrCreateEncryptionKey } from './cloud/index.js';
 export type { CloudConfig, SyncResult } from './cloud/index.js';
-
-// Team
 export { inviteMember, authenticateMember, hasPermission, listMembers, removeMember, createAuthMiddleware, loadTeamConfig, generateToken } from './team/index.js';
 export type { TeamMember, TeamRole, TeamConfig } from './team/index.js';
-
-// Pack Marketplace
 export { searchMarketplace, createPackageJson, getPublishInstructions } from './pack/marketplace.js';
 export type { PackListing } from './pack/marketplace.js';
-
-// Federation
 export { FederationNode, FederatedSearch, getOrCreateIdentity } from './federation/index.js';
 export type { PeerInfo, FederatedSearchResult, FederationMessage, NodeIdentity } from './federation/index.js';
 export { vouch, revoke, block, getTrustLevel, isBlocked, listTrusted, computeTrustScore } from './federation/trust.js';
@@ -99,35 +57,58 @@ export { addDPNoise, addDPNoiseNormalized, maskSnippet } from './federation/priv
 export type { DPConfig } from './federation/privacy.js';
 export { getBalance, getAccount, earn, spend, earnForSearchResponse, spendForSearch, getRecentTransactions } from './federation/credits.js';
 export type { CreditAccount, CreditTransaction } from './federation/credits.js';
-
-// Plugin SDK
 export { PluginManager } from './plugins/index.js';
 export type { StellavaultPlugin, PluginManifest, PluginEvent, PluginContext } from './plugins/index.js';
 export { WebhookManager } from './plugins/webhooks.js';
 export type { WebhookConfig, WebhookDelivery } from './plugins/webhooks.js';
 export { loadCustomTools } from './mcp/custom-tools.js';
 export type { CustomToolDef, LoadedCustomTool } from './mcp/custom-tools.js';
-
-// i18n
 export { t, setLocale, getLocale, detectLocale } from './i18n/index.js';
 export type { Locale } from './i18n/index.js';
-
-// Error Recovery
 export { withRetry, StellavaultError, wrapError, errors } from './utils/retry.js';
 export type { RetryOptions } from './utils/retry.js';
-
-// Factory — 전체 조립
-import { createSqliteVecStore as _createStore } from './store/index.js';
-import { createLocalEmbedder as _createEmbedder } from './indexer/index.js';
-import { createSearchEngine as _createSearch } from './search/index.js';
-import { createMcpServer as _createMcp } from './mcp/index.js';
-
-export function createKnowledgeHub(config: import('./config.js').StellavaultConfig) {
-  const embedder = _createEmbedder(config.embedding.localModel);
-  const dims = embedder.dimensions;
-  const store = _createStore(config.dbPath, dims);
-  const searchEngine = _createSearch({ store, embedder, rrfK: config.search.rrfK });
-  const mcpServer = _createMcp({ store, searchEngine, vaultPath: config.vaultPath });
-
-  return { store, embedder, searchEngine, mcpServer, config };
-}
+export declare function createKnowledgeHub(config: import('./config.js').StellavaultConfig): {
+    store: import("./store/types.js").VectorStore;
+    embedder: import("./indexer/embedder.js").Embedder;
+    searchEngine: import("./search/index.js").SearchEngine;
+    mcpServer: {
+        startStdio(): Promise<void>;
+        startHttp(port?: number): Promise<void>;
+        server: import("@modelcontextprotocol/sdk/server").Server<{
+            method: string;
+            params?: {
+                [x: string]: unknown;
+                _meta?: {
+                    [x: string]: unknown;
+                    progressToken?: string | number | undefined;
+                    "io.modelcontextprotocol/related-task"?: {
+                        taskId: string;
+                    } | undefined;
+                } | undefined;
+            } | undefined;
+        }, {
+            method: string;
+            params?: {
+                [x: string]: unknown;
+                _meta?: {
+                    [x: string]: unknown;
+                    progressToken?: string | number | undefined;
+                    "io.modelcontextprotocol/related-task"?: {
+                        taskId: string;
+                    } | undefined;
+                } | undefined;
+            } | undefined;
+        }, {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
+            } | undefined;
+        }>;
+    };
+    config: import("./config.js").StellavaultConfig;
+};
+//# sourceMappingURL=index.d.ts.map