stellavault 0.3.0 → 0.4.1

package/packages/core/dist/mcp/tools/agentic-graph.d.ts

@@ -29,6 +29,10 @@ export declare function createAgenticGraphTools(store: VectorStore, embedder: Em
                 type: string;
                 description: string;
             };
+            autoLink: {
+                type: string;
+                description: string;
+            };
             sourceTitle?: undefined;
             targetTitle?: undefined;
             context?: undefined;
@@ -41,6 +45,7 @@ export declare function createAgenticGraphTools(store: VectorStore, embedder: Em
         tags?: string[];
         type?: string;
         folder?: string;
+        autoLink?: boolean;
     }): Promise<{
         content: {
             type: "text";
@@ -70,6 +75,7 @@ export declare function createAgenticGraphTools(store: VectorStore, embedder: Em
             tags?: undefined;
             type?: undefined;
             folder?: undefined;
+            autoLink?: undefined;
         };
         required: string[];
     };

package/packages/core/dist/mcp/tools/agentic-graph.js

@@ -6,20 +6,42 @@ export function createAgenticGraphTools(store, embedder, vaultPath) {
     return [
         {
             name: 'create-knowledge-node',
-            description: 'Create a new knowledge note in the vault. AI agents use this to capture decisions, insights, or summaries during a conversation. The note is automatically indexed and appears in the knowledge graph.',
+            description: 'Create a wiki-quality knowledge note in the vault. Auto-finds related documents, generates backlinks, and adds concept tags. The note is saved with proper frontmatter and cross-references.',
             inputSchema: {
                 type: 'object',
                 properties: {
                     title: { type: 'string', description: 'Note title' },
                     content: { type: 'string', description: 'Note content (markdown)' },
                     tags: { type: 'array', items: { type: 'string' }, description: 'Tags for categorization' },
-                    type: { type: 'string', description: 'Note type: note, decision, insight, summary' },
+                    type: { type: 'string', description: 'Note type: note, decision, insight, summary, wiki' },
                     folder: { type: 'string', description: 'Vault subfolder (default: 01_Knowledge)' },
+                    autoLink: { type: 'boolean', description: 'Auto-discover and add links to related notes (default: true)' },
                 },
                 required: ['title', 'content'],
             },
             async handler(args) {
-                const { title, content, tags = [], type = 'note', folder = '01_Knowledge' } = args;
+                const { title, content, tags = [], type = 'note', folder = '01_Knowledge', autoLink = true } = args;
+                // 관련 문서 자동 탐색
+                let relatedSection = '';
+                if (autoLink) {
+                    try {
+                        const docs = await store.getAllDocuments();
+                        const titleWords = title.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+                        const related = docs
+                            .filter(d => {
+                            const dTitle = d.title.toLowerCase();
+                            return titleWords.some(w => dTitle.includes(w)) ||
+                                tags.some(t => d.tags.includes(t));
+                        })
+                            .slice(0, 5);
+                        if (related.length > 0) {
+                            relatedSection = '\n\n## Related Notes\n' +
+                                related.map(r => `- [[${r.title}]]`).join('\n') +
+                                '\n';
+                        }
+                    }
+                    catch { /* skip auto-link on error */ }
+                }
                 // frontmatter 생성
                 const date = new Date().toISOString().slice(0, 10);
                 const fm = [
@@ -32,17 +54,23 @@ export function createAgenticGraphTools(store, embedder, vaultPath) {
                     `auto_generated: true`,
                     '---',
                 ].join('\n');
-                const fullContent = `${fm}\n\n# ${title}\n\n${content}`;
-                // vault에 파일 저장
+                const fullContent = `${fm}\n\n# ${title}\n\n${content}${relatedSection}`;
+                // vault에 파일 저장 (path traversal 방지)
                 const safeTitle = title.replace(/[<>:"/\\|?*]/g, '').replace(/\s+/g, ' ').trim().slice(0, 80);
                 const dir = join(vaultPath, folder);
-                mkdirSync(dir, { recursive: true });
                 const filePath = join(dir, `${safeTitle}.md`);
+                const resolvedPath = require('node:path').resolve(filePath);
+                const resolvedVault = require('node:path').resolve(vaultPath);
+                if (!resolvedPath.startsWith(resolvedVault)) {
+                    return { content: [{ type: 'text', text: 'Error: invalid folder path.' }] };
+                }
+                mkdirSync(dir, { recursive: true });
                 writeFileSync(filePath, fullContent, 'utf-8');
+                const relatedCount = relatedSection ? relatedSection.split('\n').filter(l => l.startsWith('- ')).length : 0;
                 return {
                     content: [{
                             type: 'text',
-                            text: `Created knowledge node: "${title}" at ${folder}/${safeTitle}.md\nTags: ${tags.join(', ') || 'none'}\nType: ${type}\n\nRun 'stellavault index' to add to the graph.`,
+                            text: `Created wiki-quality note: "${title}" at ${folder}/${safeTitle}.md\nTags: ${tags.join(', ') || 'none'}\nType: ${type}\nAuto-linked: ${relatedCount} related notes\n\nThe note will appear in the graph after next index.`,
                         }],
                 };
             },

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

@@ -0,0 +1,29 @@
+import type { SearchEngine } from '../../search/index.js';
+export declare function createAskTool(searchEngine: SearchEngine, vaultPath: string): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            question: {
+                type: "string";
+                description: string;
+            };
+            save: {
+                type: "boolean";
+                description: string;
+            };
+        };
+        required: readonly ["question"];
+    };
+    handler: (args: {
+        question: string;
+        save?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=ask.d.ts.map

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

@@ -0,0 +1,40 @@
+// MCP Tool: ask — Q&A with auto-filing to vault
+import { askVault } from '../../intelligence/ask-engine.js';
+export function createAskTool(searchEngine, vaultPath) {
+    return {
+        name: 'ask',
+        description: 'Ask a question about your knowledge base. Searches vault using hybrid AI search (BM25 + vector + RRF), returns structured results with sources. Use the results to compose your own AI-powered answer. Optionally saves as a new note.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                question: {
+                    type: 'string',
+                    description: 'The question to ask about your knowledge',
+                },
+                save: {
+                    type: 'boolean',
+                    description: 'Save the answer as a new note in the vault (default: false)',
+                },
+            },
+            required: ['question'],
+        },
+        handler: async (args) => {
+            const result = await askVault(searchEngine, args.question, {
+                limit: 10,
+                save: args.save ?? false,
+                vaultPath,
+            });
+            const text = [
+                result.answer,
+                '',
+                result.savedTo ? `Saved to: ${result.savedTo}` : '',
+                '',
+                `Sources: ${result.sources.length} documents found`,
+            ].filter(Boolean).join('\n');
+            return {
+                content: [{ type: 'text', text }],
+            };
+        },
+    };
+}
+//# sourceMappingURL=ask.js.map

package/packages/core/dist/mcp/tools/generate-draft.d.ts

@@ -0,0 +1,34 @@
+import type { SearchEngine } from '../../search/index.js';
+export declare function createGenerateDraftTool(searchEngine: SearchEngine, vaultPath: string): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            topic: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            maxSources: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    handler: (args: {
+        topic?: string;
+        format?: string;
+        maxSources?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=generate-draft.d.ts.map

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

@@ -0,0 +1,120 @@
+// 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stellavault/core",
-  "version": "0.1.0",
+  "version": "0.4.0",
   "description": "Stellavault core engine — indexer, hybrid search, vector store, MCP server",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,18 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./intelligence/youtube-extractor": {
+      "import": "./dist/intelligence/youtube-extractor.js",
+      "types": "./dist/intelligence/youtube-extractor.d.ts"
+    },
+    "./intelligence/file-extractors": {
+      "import": "./dist/intelligence/file-extractors.js",
+      "types": "./dist/intelligence/file-extractors.d.ts"
+    },
+    "./intelligence/draft-generator": {
+      "import": "./dist/intelligence/draft-generator.js",
+      "types": "./dist/intelligence/draft-generator.d.ts"
     }
   },
   "scripts": {
@@ -26,7 +38,9 @@
     "vitest": "^3.0.0"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.82.0",
     "@modelcontextprotocol/sdk": "^1.28.0",
+    "@types/multer": "^2.1.0",
     "@xenova/transformers": "^2.17.2",
     "b4a": "^1.8.0",
     "better-sqlite3": "^12.8.0",
@@ -35,6 +49,11 @@
     "express": "^5.2.1",
     "gray-matter": "^4.0.3",
     "hyperswarm": "^4.17.0",
-    "sqlite-vec": "^0.1.7"
+    "mammoth": "^1.12.0",
+    "multer": "^2.1.1",
+    "officeparser": "^6.0.7",
+    "sqlite-vec": "^0.1.7",
+    "unpdf": "^1.4.0",
+    "xlsx": "^0.18.5"
   }
 }