stellavault 0.4.4 → 0.5.0

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

@@ -1,246 +0,0 @@
-// 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

@@ -1,15 +0,0 @@
-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

@@ -1,60 +0,0 @@
-// 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

@@ -1,40 +0,0 @@
-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

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

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

@@ -1,6 +0,0 @@
-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

@@ -1,81 +0,0 @@
-// 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/dist/i18n/note-strings.d.ts

@@ -1,5 +0,0 @@
-export type NoteLocale = 'en' | 'ko' | 'ja' | 'zh';
-export declare function setNoteLocale(locale: NoteLocale): void;
-export declare function getNoteLocale(): NoteLocale;
-export declare function nt(key: string): string;
-//# sourceMappingURL=note-strings.d.ts.map

package/packages/core/dist/i18n/note-strings.js

@@ -1,94 +0,0 @@
-// 저장 노트용 다국어 문자열 — 사용자 언어에 따라 노트 섹션 제목 결정
-const strings = {
-    en: {
-        'summary': 'Summary',
-        'description': 'Description',
-        'transcript': 'Transcript',
-        'views': 'Views',
-        'relatedDocs': 'Related Documents',
-        'relatedConcepts': 'Related Concepts',
-        'relatedTags': 'Related Tags',
-        'source': 'Source',
-        'articles': 'Articles',
-        'concepts': 'Concepts',
-        'exploreFurther': 'Explore Further',
-        'noResults': 'No results found',
-        'tryDifferent': 'Try different keywords or create a note on this topic.',
-        'digDeeper': 'Dig deeper',
-        'findGaps': 'Find knowledge gaps',
-        'thisConceptAppears': 'This concept appears in',
-        'documents': 'documents',
-        'compiledFrom': 'Compiled',
-        'wikiArticlesFrom': 'wiki articles from',
-        'sourceDocuments': 'source documents',
-        'staleWarning': "documents haven't been modified in 6+ months. Run `stellavault decay` to review.",
-        'gapsFound': 'knowledge gaps found. Start filling the most critical ones.',
-        'duplicatesFound': 'duplicate documents detected. Run `stellavault duplicates` to merge.',
-        'isolatedFound': 'isolated notes found. Add tags or links to connect them.',
-        'healthy': 'Your knowledge base is healthy! Keep it up.',
-        'youtubeVideo': 'YouTube video',
-    },
-    ko: {
-        'summary': '핵심 요약',
-        'description': '설명',
-        'transcript': '영상 내용',
-        'views': '조회수',
-        'relatedDocs': '관련 문서',
-        'relatedConcepts': '관련 개념',
-        'relatedTags': '관련 태그',
-        'source': '원본',
-        'articles': '문서 목록',
-        'concepts': '개념',
-        'exploreFurther': '더 알아보기',
-        'noResults': '검색 결과 없음',
-        'tryDifferent': '다른 키워드로 검색하거나, 이 주제에 대한 노트를 작성해보세요.',
-        'digDeeper': '더 깊이 알아보기',
-        'findGaps': '빠진 지식 찾기',
-        'thisConceptAppears': '이 개념이 등장하는 문서',
-        'documents': '개',
-        'compiledFrom': '컴파일됨',
-        'wikiArticlesFrom': '개 위키 문서 생성 (원본',
-        'sourceDocuments': '개)',
-        'staleWarning': '개 문서가 6개월 이상 수정되지 않았어요. `stellavault decay`로 확인하세요.',
-        'gapsFound': '개 지식 빈틈이 발견됐어요. 중요한 것부터 채워보세요.',
-        'duplicatesFound': '개 겹치는 문서가 있어요. `stellavault duplicates`로 합치세요.',
-        'isolatedFound': '개 떨어진 노트가 있어요. 태그나 링크로 연결하세요.',
-        'healthy': '지식이 건강해요! 계속 유지하세요.',
-        'youtubeVideo': 'YouTube 영상',
-    },
-    ja: {
-        'summary': '要約',
-        'description': '説明',
-        'transcript': '内容',
-        'views': '再生回数',
-        'relatedDocs': '関連ドキュメント',
-        'relatedConcepts': '関連コンセプト',
-        'source': 'ソース',
-        'noResults': '検索結果なし',
-        'healthy': 'ナレッジベースは健全です！',
-        'youtubeVideo': 'YouTube動画',
-    },
-    zh: {
-        'summary': '摘要',
-        'description': '描述',
-        'transcript': '内容',
-        'views': '观看次数',
-        'relatedDocs': '相关文档',
-        'relatedConcepts': '相关概念',
-        'source': '来源',
-        'noResults': '未找到结果',
-        'healthy': '知识库很健康！',
-        'youtubeVideo': 'YouTube视频',
-    },
-};
-let currentNoteLocale = 'en';
-export function setNoteLocale(locale) {
-    currentNoteLocale = locale;
-}
-export function getNoteLocale() {
-    return currentNoteLocale;
-}
-export function nt(key) {
-    return strings[currentNoteLocale]?.[key] ?? strings.en[key] ?? key;
-}
-//# sourceMappingURL=note-strings.js.map