stellavault 0.4.4 → 0.5.0

package/packages/core/dist/mcp/tools/generate-draft.js

@@ -1,120 +0,0 @@
-// MCP Tool: generate-draft — Claude Code에서 직접 초안 생성
-// Claude가 vault 컨텍스트를 받아 직접 글을 쓰도록 구조화된 재료를 반환
-// 비용: $0 (이미 Claude Code 세션 안)
-import { scanRawDirectory, extractConcepts } from '../../intelligence/wiki-compiler.js';
-import { loadConfig, DEFAULT_FOLDERS } from '../../config.js';
-import { resolve } from 'node:path';
-import { existsSync } from 'node:fs';
-export function createGenerateDraftTool(searchEngine, vaultPath) {
-    return {
-        name: 'generate-draft',
-        description: 'Gather knowledge from your vault to write a draft. Returns structured context (notes, concepts, excerpts) so you can compose a blog post, report, or outline. Use this when the user asks you to "write a draft", "blog post from my notes", or "summarize my knowledge about X".',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                topic: {
-                    type: 'string',
-                    description: 'Topic or keyword to focus on. Leave empty for all knowledge.',
-                },
-                format: {
-                    type: 'string',
-                    enum: ['blog', 'report', 'outline'],
-                    description: 'Desired output format (default: blog)',
-                },
-                maxSources: {
-                    type: 'number',
-                    description: 'Maximum number of source documents to include (default: 10)',
-                },
-            },
-        },
-        handler: async (args) => {
-            const { topic, format = 'blog', maxSources = 10 } = args;
-            const config = loadConfig();
-            const folders = config.folders ?? DEFAULT_FOLDERS;
-            // 1. 토픽 기반 검색 (있으면)
-            let searchResults = [];
-            if (topic) {
-                const results = await searchEngine.search({ query: topic, limit: maxSources });
-                searchResults = results.map(r => ({
-                    title: r.document?.title ?? 'Untitled',
-                    content: r.chunk?.content ?? '',
-                    filePath: r.document?.filePath ?? '',
-                    score: r.score ?? 0,
-                }));
-            }
-            // 2. vault 전체 스캔 (검색 결과가 부족하면)
-            const allDocs = [];
-            for (const dir of [folders.fleeting, folders.literature, folders.permanent, folders.wiki]) {
-                const fullDir = resolve(vaultPath, dir);
-                if (existsSync(fullDir)) {
-                    const docs = scanRawDirectory(fullDir);
-                    allDocs.push(...docs);
-                }
-            }
-            // 토픽 필터
-            const relevantDocs = topic
-                ? allDocs.filter(d => d.title.toLowerCase().includes(topic.toLowerCase()) ||
-                    d.tags.some(t => t.toLowerCase().includes(topic.toLowerCase())) ||
-                    d.content.toLowerCase().includes(topic.toLowerCase()))
-                : allDocs;
-            // 3. 개념 추출
-            const concepts = extractConcepts(relevantDocs.length > 0 ? relevantDocs : allDocs);
-            const topConcepts = [...concepts.entries()]
-                .sort((a, b) => b[1].length - a[1].length)
-                .slice(0, 8)
-                .map(([name, docs]) => ({ name, documentCount: docs.length }));
-            // 4. 발췌 준비
-            const excerpts = (searchResults.length > 0 ? searchResults : relevantDocs.slice(0, maxSources))
-                .map(doc => {
-                const body = doc.content
-                    .replace(/^---[\s\S]*?---\n?/, '') // frontmatter 제거
-                    .replace(/^#+\s+.+\n/m, '') // 첫 heading 제거
-                    .trim()
-                    .slice(0, 500);
-                return {
-                    title: doc.title,
-                    excerpt: body,
-                    filePath: doc.filePath,
-                };
-            })
-                .filter(e => e.excerpt.length > 20);
-            // 5. 구조화된 컨텍스트 반환
-            const context = {
-                topic: topic ?? 'All Knowledge',
-                format,
-                totalDocuments: relevantDocs.length || allDocs.length,
-                concepts: topConcepts,
-                sources: excerpts,
-                instruction: `Use the sources above to write a ${format}. Rules:
-- Only use information from the provided sources
-- Cite sources using [[title]] wikilink format
-- Write in the same language as the source material
-- Add your analysis connecting ideas across sources
-- Format: ${format === 'blog' ? 'Engaging blog post with intro, body sections, conclusion' : format === 'report' ? 'Formal report with executive summary, sections, conclusion' : 'Hierarchical outline with numbered sections'}`,
-            };
-            const text = `# Draft Context: ${context.topic}
-
-## Format: ${format}
-## Sources: ${context.totalDocuments} documents, ${excerpts.length} excerpts
-
-## Key Concepts
-${topConcepts.map(c => `- **${c.name}** (${c.documentCount} documents)`).join('\n')}
-
-## Source Excerpts
-
-${excerpts.map(e => `### ${e.title}
-> ${e.excerpt}
-`).join('\n')}
-
-## Instructions
-${context.instruction}
-
----
-Please write the ${format} draft based on the context above. Save the result to the vault's _drafts/ folder.`;
-            return {
-                content: [{ type: 'text', text }],
-            };
-        },
-    };
-}
-//# sourceMappingURL=generate-draft.js.map

package/packages/core/dist/mcp/tools/get-document.d.ts

@@ -1,35 +0,0 @@
-import type { VectorStore } from '../../store/types.js';
-export declare const getDocumentToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            id: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleGetDocument(store: VectorStore, args: {
-    id: string;
-}): Promise<{
-    error: string;
-    title?: undefined;
-    filePath?: undefined;
-    content?: undefined;
-    tags?: undefined;
-    frontmatter?: undefined;
-    lastModified?: undefined;
-} | {
-    title: string;
-    filePath: string;
-    content: string;
-    tags: string[];
-    frontmatter: Record<string, unknown>;
-    lastModified: string;
-    error?: undefined;
-}>;
-//# sourceMappingURL=get-document.d.ts.map

package/packages/core/dist/mcp/tools/get-document.js

@@ -1,25 +0,0 @@
-export const getDocumentToolDef = {
-    name: 'get-document',
-    description: '문서 ID 또는 파일 경로로 전체 문서 내용을 가져옵니다.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            id: { type: 'string', description: '문서 ID 또는 파일 경로' },
-        },
-        required: ['id'],
-    },
-};
-export async function handleGetDocument(store, args) {
-    const doc = await store.getDocument(args.id);
-    if (!doc)
-        return { error: `Document not found: ${args.id}` };
-    return {
-        title: doc.title,
-        filePath: doc.filePath,
-        content: doc.content,
-        tags: doc.tags,
-        frontmatter: doc.frontmatter,
-        lastModified: doc.lastModified,
-    };
-}
-//# sourceMappingURL=get-document.js.map

package/packages/core/dist/mcp/tools/get-evolution.d.ts

@@ -1,28 +0,0 @@
-import type { VectorStore } from '../../store/types.js';
-export declare function createGetEvolutionTool(store: VectorStore): {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            topic: {
-                type: "string";
-                description: string;
-            };
-            limit: {
-                type: "number";
-                description: string;
-            };
-        };
-    };
-    handler: (args: {
-        topic?: string;
-        limit?: number;
-    }) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-    }>;
-};
-//# sourceMappingURL=get-evolution.d.ts.map

package/packages/core/dist/mcp/tools/get-evolution.js

@@ -1,70 +0,0 @@
-// Design Ref: F02 — 지식 진화 타임라인 MCP tool
-// Plan SC: SC-01 주제별 드리프트 반환
-export function createGetEvolutionTool(store) {
-    return {
-        name: 'get-evolution',
-        description: 'Track semantic evolution of knowledge. Shows which topics have changed the most in meaning over time.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                topic: {
-                    type: 'string',
-                    description: 'Optional topic/tag to filter. Omit for vault-wide analysis.',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max results to return (default: 10)',
-                },
-            },
-        },
-        handler: async (args) => {
-            const limit = args.limit ?? 10;
-            const docs = await store.getAllDocuments();
-            const embeddings = await store.getDocumentEmbeddings();
-            // Filter by topic/tag if provided
-            let filteredDocs = docs;
-            if (args.topic) {
-                const topicLower = args.topic.toLowerCase();
-                filteredDocs = docs.filter((d) => d.tags.some((t) => t.toLowerCase().includes(topicLower)) ||
-                    d.title.toLowerCase().includes(topicLower));
-            }
-            // Build embedding maps (current only — single-point, but foundation for multi-version)
-            const currentEmbeddings = new Map();
-            const titles = new Map();
-            for (const doc of filteredDocs) {
-                const emb = embeddings.get(doc.id);
-                if (emb) {
-                    currentEmbeddings.set(doc.id, emb);
-                    titles.set(doc.id, doc.title);
-                }
-            }
-            // For now, use modification time as proxy for "evolution"
-            // Sort by most recently modified with content changes
-            const recentlyChanged = filteredDocs
-                .filter((d) => d.lastModified)
-                .sort((a, b) => new Date(b.lastModified).getTime() - new Date(a.lastModified).getTime())
-                .slice(0, limit)
-                .map((d) => ({
-                documentId: d.id,
-                title: d.title,
-                lastModified: d.lastModified,
-                tags: d.tags.slice(0, 5),
-                daysSinceModified: Math.round((Date.now() - new Date(d.lastModified).getTime()) / 86400000),
-            }));
-            return {
-                content: [{
-                        type: 'text',
-                        text: JSON.stringify({
-                            topic: args.topic ?? 'all',
-                            totalDocuments: filteredDocs.length,
-                            recentlyEvolved: recentlyChanged,
-                            summary: recentlyChanged.length > 0
-                                ? `최근 변화가 가장 큰 문서: "${recentlyChanged[0].title}" (${recentlyChanged[0].daysSinceModified}일 전 수정)`
-                                : '분석할 문서가 없습니다.',
-                        }, null, 2),
-                    }],
-            };
-        },
-    };
-}
-//# sourceMappingURL=get-evolution.js.map

package/packages/core/dist/mcp/tools/get-related.d.ts

@@ -1,32 +0,0 @@
-import type { SearchEngine } from '../../search/index.js';
-import type { VectorStore } from '../../store/types.js';
-export declare const getRelatedToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            id: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleGetRelated(store: VectorStore, searchEngine: SearchEngine, args: {
-    id: string;
-    limit?: number;
-}): Promise<{
-    title: string;
-    filePath: string;
-    score: number;
-    tags: string[];
-}[] | {
-    error: string;
-}>;
-//# sourceMappingURL=get-related.d.ts.map

package/packages/core/dist/mcp/tools/get-related.js

@@ -1,33 +0,0 @@
-export const getRelatedToolDef = {
-    name: 'get-related',
-    description: '특정 문서와 의미적으로 관련된 문서들을 반환합니다.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            id: { type: 'string', description: '기준 문서 ID 또는 파일 경로' },
-            limit: { type: 'number', description: '반환할 관련 문서 수 (기본: 5)' },
-        },
-        required: ['id'],
-    },
-};
-export async function handleGetRelated(store, searchEngine, args) {
-    const doc = await store.getDocument(args.id);
-    if (!doc)
-        return { error: `Document not found: ${args.id}` };
-    // 문서 제목+내용 일부를 쿼리로 사용하여 관련 문서 검색
-    const query = `${doc.title} ${doc.content.slice(0, 200)}`;
-    const results = await searchEngine.search({
-        query,
-        limit: (args.limit ?? 5) + 1, // 자기 자신 제외용 +1
-    });
-    return results
-        .filter(r => r.document.id !== args.id)
-        .slice(0, args.limit ?? 5)
-        .map(r => ({
-        title: r.document.title,
-        filePath: r.document.filePath,
-        score: Math.round(r.score * 1000) / 1000,
-        tags: r.document.tags,
-    }));
-}
-//# sourceMappingURL=get-related.js.map

package/packages/core/dist/mcp/tools/learning-path.d.ts

@@ -1,23 +0,0 @@
-import type { VectorStore } from '../../store/types.js';
-export declare function createLearningPathTool(store: VectorStore): {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            limit: {
-                type: string;
-                description: string;
-            };
-        };
-    };
-    handler(args: {
-        limit?: number;
-    }): Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-    }>;
-};
-//# sourceMappingURL=learning-path.d.ts.map

package/packages/core/dist/mcp/tools/learning-path.js

@@ -1,45 +0,0 @@
-// MCP Tool: get-learning-path (F-A11)
-import { DecayEngine } from '../../intelligence/decay-engine.js';
-import { detectKnowledgeGaps } from '../../intelligence/gap-detector.js';
-import { generateLearningPath } from '../../intelligence/learning-path.js';
-export function createLearningPathTool(store) {
-    return {
-        name: 'get-learning-path',
-        description: 'Generate a personalized learning path based on knowledge decay and gaps. Returns prioritized list of what to review, explore, or bridge.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                limit: { type: 'number', description: 'Max items to return (default: 10)' },
-            },
-        },
-        async handler(args) {
-            const limit = args.limit ?? 10;
-            const db = store.getDb();
-            if (!db)
-                return { content: [{ type: 'text', text: 'Database not available' }] };
-            const decayEngine = new DecayEngine(db);
-            const decayReport = await decayEngine.computeAll();
-            let gaps = [];
-            try {
-                const gapReport = await detectKnowledgeGaps(store);
-                gaps = gapReport.gaps ?? [];
-            }
-            catch { /* ignore */ }
-            const path = generateLearningPath({ decayReport, gaps }, limit);
-            const lines = [
-                `🎯 Learning Path (${path.items.length} items, ~${path.summary.estimatedMinutes}min)`,
-                '',
-            ];
-            for (const item of path.items) {
-                const icon = item.category === 'review' ? '📖' : item.category === 'bridge' ? '🌉' : '🔭';
-                lines.push(`${icon} [${item.priority}] ${item.title} (${item.score}pt)`);
-                lines.push(`   ${item.reason}`);
-            }
-            if (path.items.length === 0) {
-                lines.push('All clear! Knowledge is in great shape.');
-            }
-            return { content: [{ type: 'text', text: lines.join('\n') }] };
-        },
-    };
-}
-//# sourceMappingURL=learning-path.js.map

package/packages/core/dist/mcp/tools/link-code.d.ts

@@ -1,34 +0,0 @@
-import type { SearchEngine } from '../../search/index.js';
-export declare function createLinkCodeTool(searchEngine: SearchEngine): {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            filePath: {
-                type: "string";
-                description: string;
-            };
-            content: {
-                type: "string";
-                description: string;
-            };
-            limit: {
-                type: "number";
-                description: string;
-            };
-        };
-        required: readonly ["filePath"];
-    };
-    handler: (args: {
-        filePath: string;
-        content?: string;
-        limit?: number;
-    }) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-    }>;
-};
-//# sourceMappingURL=link-code.d.ts.map

package/packages/core/dist/mcp/tools/link-code.js

@@ -1,44 +0,0 @@
-// Design Ref: F15 — 코드-지식 링커 MCP tool
-// Plan SC: SC-03 코드 파일에서 관련 노트 매칭
-import { linkCodeToKnowledge } from '../../intelligence/code-linker.js';
-export function createLinkCodeTool(searchEngine) {
-    return {
-        name: 'link-code',
-        description: 'Find knowledge notes related to a code file. Extracts keywords from file path and content, then searches the knowledge base.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                filePath: {
-                    type: 'string',
-                    description: 'Path to the code file (e.g., src/auth/middleware.ts)',
-                },
-                content: {
-                    type: 'string',
-                    description: 'Optional: code file content for deeper keyword extraction',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max related notes to return (default: 5)',
-                },
-            },
-            required: ['filePath'],
-        },
-        handler: async (args) => {
-            const result = await linkCodeToKnowledge(searchEngine, args.filePath, args.content, args.limit ?? 5);
-            return {
-                content: [{
-                        type: 'text',
-                        text: JSON.stringify({
-                            filePath: result.filePath,
-                            extractedKeywords: result.keywords,
-                            relatedNotes: result.relatedNotes,
-                            summary: result.relatedNotes.length > 0
-                                ? `"${result.filePath}" 관련 노트 ${result.relatedNotes.length}개 발견. 최상위: "${result.relatedNotes[0].title}"`
-                                : `"${result.filePath}"에 대한 관련 노트를 찾지 못했습니다.`,
-                        }, null, 2),
-                    }],
-            };
-        },
-    };
-}
-//# sourceMappingURL=link-code.js.map

package/packages/core/dist/mcp/tools/list-topics.d.ts

@@ -1,15 +0,0 @@
-import type { VectorStore } from '../../store/types.js';
-export declare const listTopicsToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {};
-    };
-};
-export declare function handleListTopics(store: VectorStore): Promise<{
-    topics: import("../../index.js").TopicInfo[];
-    totalDocuments: number;
-    totalChunks: number;
-}>;
-//# sourceMappingURL=list-topics.d.ts.map

package/packages/core/dist/mcp/tools/list-topics.js

@@ -1,18 +0,0 @@
-export const listTopicsToolDef = {
-    name: 'list-topics',
-    description: '지식 베이스의 전체 토픽/태그 목록과 문서 수를 반환합니다.',
-    inputSchema: {
-        type: 'object',
-        properties: {},
-    },
-};
-export async function handleListTopics(store) {
-    const topics = await store.getTopics();
-    const stats = await store.getStats();
-    return {
-        topics,
-        totalDocuments: stats.documentCount,
-        totalChunks: stats.chunkCount,
-    };
-}
-//# sourceMappingURL=list-topics.js.map

package/packages/core/dist/mcp/tools/search.d.ts

@@ -1,39 +0,0 @@
-import type { SearchEngine } from '../../search/index.js';
-export declare const searchToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-            };
-            tags: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleSearch(searchEngine: SearchEngine, args: {
-    query: string;
-    limit?: number;
-    tags?: string[];
-}): Promise<{
-    title: string;
-    filePath: string;
-    heading: string;
-    content: string;
-    score: number;
-    tags: string[];
-}[]>;
-//# sourceMappingURL=search.d.ts.map

package/packages/core/dist/mcp/tools/search.js

@@ -1,29 +0,0 @@
-export const searchToolDef = {
-    name: 'search',
-    description: '개인 지식 베이스에서 관련 문서/청크를 검색합니다. 자연어 쿼리와 키워드 모두 지원합니다.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            query: { type: 'string', description: '검색 쿼리 (자연어 또는 키워드)' },
-            limit: { type: 'number', description: '반환할 결과 수 (기본: 5)' },
-            tags: { type: 'array', items: { type: 'string' }, description: '태그 필터' },
-        },
-        required: ['query'],
-    },
-};
-export async function handleSearch(searchEngine, args) {
-    const results = await searchEngine.search({
-        query: args.query,
-        limit: args.limit ?? 5,
-        tags: args.tags,
-    });
-    return results.map(r => ({
-        title: r.document.title,
-        filePath: r.document.filePath,
-        heading: r.chunk.heading,
-        content: r.chunk.content,
-        score: Math.round(r.score * 1000) / 1000,
-        tags: r.document.tags,
-    }));
-}
-//# sourceMappingURL=search.js.map

package/packages/core/dist/mcp/tools/snapshot.d.ts

@@ -1,47 +0,0 @@
-import type { SearchEngine } from '../../search/index.js';
-export declare const createSnapshotToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            name: {
-                type: string;
-                description: string;
-            };
-            queries: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare const loadSnapshotToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            name: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleCreateSnapshot(searchEngine: SearchEngine, args: {
-    name: string;
-    queries: string[];
-}): Promise<{
-    saved: string;
-    resultCount: number;
-}>;
-export declare function handleLoadSnapshot(args: {
-    name: string;
-}): Promise<any>;
-//# sourceMappingURL=snapshot.d.ts.map