stellavault 0.3.0 → 0.4.0

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/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,10 @@
     ".": {
       "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"
     }
   },
   "scripts": {