stellavault 0.4.4 → 0.5.0

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

@@ -1,33 +0,0 @@
-import type { DecayEngine } from '../../intelligence/decay-engine.js';
-export declare const getDecayStatusToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            threshold: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-            };
-        };
-    };
-};
-export declare function handleGetDecayStatus(decayEngine: DecayEngine, args: {
-    threshold?: number;
-    limit?: number;
-}): Promise<{
-    count: number;
-    threshold: number;
-    notes: {
-        title: string;
-        retrievability: number;
-        stability: number;
-        lastAccess: string;
-    }[];
-    tip: string;
-}>;
-//# sourceMappingURL=decay.d.ts.map

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

@@ -1,32 +0,0 @@
-// Design Ref: §4.2 — MCP tool: get-decay-status
-// Plan SC: SC-04
-export const getDecayStatusToolDef = {
-    name: 'get-decay-status',
-    description: '잊어가는 지식 노트를 조회합니다. 기억 강도(retrievability)가 낮은 노트 목록을 반환하여 리마인드합니다.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            threshold: { type: 'number', description: '감쇠 임계값 (0~1, default: 0.5). 이 값 이하인 노트를 반환' },
-            limit: { type: 'number', description: '반환할 최대 노트 수 (default: 20)' },
-        },
-    },
-};
-export async function handleGetDecayStatus(decayEngine, args) {
-    const threshold = args.threshold ?? 0.5;
-    const limit = args.limit ?? 20;
-    const decaying = await decayEngine.getDecaying(threshold, limit);
-    return {
-        count: decaying.length,
-        threshold,
-        notes: decaying.map(d => ({
-            title: d.title,
-            retrievability: Math.round(d.retrievability * 100) / 100,
-            stability: Math.round(d.stability * 10) / 10,
-            lastAccess: d.lastAccess,
-        })),
-        tip: decaying.length > 0
-            ? `${decaying.length}개의 노트를 잊어가고 있습니다. 리뷰를 권장합니다.`
-            : '모든 지식이 건강한 상태입니다!',
-    };
-}
-//# sourceMappingURL=decay.js.map

package/packages/core/dist/mcp/tools/decision-journal.d.ts

@@ -1,78 +0,0 @@
-export declare const logDecisionToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            title: {
-                type: string;
-                description: string;
-            };
-            context: {
-                type: string;
-                description: string;
-            };
-            decision: {
-                type: string;
-                description: string;
-            };
-            alternatives: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-            reasoning: {
-                type: string;
-                description: string;
-            };
-            project: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare const findDecisionsToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleLogDecision(vaultPath: string, args: {
-    title: string;
-    context?: string;
-    decision: string;
-    alternatives?: string[];
-    reasoning: string;
-    project?: string;
-}): Promise<{
-    saved: string;
-    fileName: string;
-}>;
-export declare function handleFindDecisions(vaultPath: string, args: {
-    query: string;
-}): Promise<{
-    decisions: never[];
-    message: string;
-    total?: undefined;
-} | {
-    decisions: {
-        file: string;
-        content: string;
-        score: number;
-    }[];
-    total: number;
-    message?: undefined;
-}>;
-//# sourceMappingURL=decision-journal.d.ts.map

package/packages/core/dist/mcp/tools/decision-journal.js

@@ -1,79 +0,0 @@
-// Design Ref: §12.1 F14 — 결정 저널 (기술 결정 자동 기록)
-import { writeFileSync, existsSync, mkdirSync, readdirSync, readFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-export const logDecisionToolDef = {
-    name: 'log-decision',
-    description: '기술적 결정을 구조화하여 기록합니다. 나중에 "왜 이 선택을 했지?"에 답변할 수 있습니다.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            title: { type: 'string', description: '결정 제목 (예: Zustand 대신 Jotai 선택)' },
-            context: { type: 'string', description: '결정 배경/상황' },
-            decision: { type: 'string', description: '선택한 내용' },
-            alternatives: { type: 'array', items: { type: 'string' }, description: '고려한 대안들' },
-            reasoning: { type: 'string', description: '선택 이유' },
-            project: { type: 'string', description: '관련 프로젝트명' },
-        },
-        required: ['title', 'decision', 'reasoning'],
-    },
-};
-export const findDecisionsToolDef = {
-    name: 'find-decisions',
-    description: '과거 기술 결정을 검색합니다.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            query: { type: 'string', description: '검색 쿼리' },
-        },
-        required: ['query'],
-    },
-};
-export async function handleLogDecision(vaultPath, args) {
-    const decisionsDir = join(vaultPath, 'decisions');
-    mkdirSync(decisionsDir, { recursive: true });
-    const date = new Date().toISOString().slice(0, 10);
-    const slug = args.title.replace(/[^a-zA-Z가-힣0-9\s-]/g, '').replace(/\s+/g, '-').slice(0, 50);
-    if (!slug)
-        throw new Error('Invalid decision title');
-    const fileName = `${date}-${slug}.md`;
-    const content = [
-        '---',
-        `title: "${args.title}"`,
-        `date: ${date}`,
-        `project: "${args.project ?? ''}"`,
-        'type: decision',
-        '---',
-        '',
-        `# ${args.title}`,
-        '',
-        args.context ? `## 배경\n\n${args.context}\n` : '',
-        `## 결정\n\n${args.decision}\n`,
-        args.alternatives?.length
-            ? `## 고려한 대안\n\n${args.alternatives.map(a => `- ${a}`).join('\n')}\n`
-            : '',
-        `## 이유\n\n${args.reasoning}\n`,
-    ].filter(Boolean).join('\n');
-    const filePath = resolve(decisionsDir, fileName);
-    if (!filePath.startsWith(resolve(decisionsDir))) {
-        throw new Error('Path traversal detected');
-    }
-    writeFileSync(filePath, content, 'utf-8');
-    return { saved: filePath, fileName };
-}
-export async function handleFindDecisions(vaultPath, args) {
-    const decisionsDir = join(vaultPath, 'decisions');
-    if (!existsSync(decisionsDir))
-        return { decisions: [], message: 'No decisions directory' };
-    const files = readdirSync(decisionsDir).filter(f => f.endsWith('.md'));
-    const query = args.query.toLowerCase();
-    const matches = files
-        .map(f => {
-        const content = readFileSync(join(decisionsDir, f), 'utf-8');
-        const score = content.toLowerCase().includes(query) ? 1 : 0;
-        return { file: f, content: content.slice(0, 300), score };
-    })
-        .filter(m => m.score > 0)
-        .slice(0, 10);
-    return { decisions: matches, total: files.length };
-}
-//# sourceMappingURL=decision-journal.js.map

package/packages/core/dist/mcp/tools/detect-gaps.d.ts

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

package/packages/core/dist/mcp/tools/detect-gaps.js

@@ -1,47 +0,0 @@
-// Design Ref: §3.5 — MCP detect-gaps tool
-// Plan SC: SC-04 MCP detect-gaps가 클러스터 간 갭 + 고립 노드 반환
-import { detectKnowledgeGaps } from '../../intelligence/gap-detector.js';
-export function createDetectGapsTool(store) {
-    return {
-        name: 'detect-gaps',
-        description: 'Detect knowledge gaps between topic clusters. Returns gap severity, isolated nodes, and suggested topics to bridge gaps.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                minSeverity: {
-                    type: 'string',
-                    description: 'Minimum gap severity to include: high, medium, or low',
-                    enum: ['high', 'medium', 'low'],
-                },
-            },
-        },
-        handler: async (args) => {
-            const minSeverity = args.minSeverity ?? 'medium';
-            const report = await detectKnowledgeGaps(store);
-            const sevOrder = { high: 0, medium: 1, low: 2 };
-            const threshold = sevOrder[minSeverity] ?? 1;
-            const filtered = report.gaps.filter((g) => sevOrder[g.severity] <= threshold);
-            return {
-                content: [{
-                        type: 'text',
-                        text: JSON.stringify({
-                            totalClusters: report.totalClusters,
-                            totalGaps: filtered.length,
-                            gaps: filtered.map((g) => ({
-                                clusterA: g.clusterA,
-                                clusterB: g.clusterB,
-                                bridgeCount: g.bridgeCount,
-                                severity: g.severity,
-                                suggestedTopic: g.suggestedTopic,
-                            })),
-                            isolatedNodes: report.isolatedNodes.slice(0, 10),
-                            suggestion: filtered.length > 0
-                                ? `${filtered[0].suggestedTopic} 주제로 노트를 작성하면 지식 갭을 줄일 수 있습니다.`
-                                : '현재 심각한 지식 갭이 없습니다.',
-                        }, null, 2),
-                    }],
-            };
-        },
-    };
-}
-//# sourceMappingURL=detect-gaps.js.map

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

@@ -1,29 +0,0 @@
-import type { VectorStore } from '../../store/types.js';
-export declare const exportToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            outputPath: {
-                type: string;
-                description: string;
-            };
-            format: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleExport(store: VectorStore, args: {
-    outputPath: string;
-    format?: string;
-}): Promise<{
-    exported: number;
-    path: string;
-    format: string;
-}>;
-//# sourceMappingURL=export.d.ts.map

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

@@ -1,60 +0,0 @@
-// Design Ref: §12.1 F20 — 지식 내보내기 포맷 (락인 방지)
-import { writeFileSync, mkdirSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { homedir } from 'node:os';
-const ALLOWED_EXPORT_DIRS = [
-    resolve(homedir(), '.stellavault'),
-    resolve('.'),
-];
-function validateExportPath(outputPath) {
-    const resolved = resolve(outputPath);
-    const isAllowed = ALLOWED_EXPORT_DIRS.some(dir => resolved.startsWith(resolve(dir)));
-    if (!isAllowed) {
-        throw new Error(`Export path must be within current directory or ~/.stellavault/. Got: ${resolved}`);
-    }
-    return resolved;
-}
-export const exportToolDef = {
-    name: 'export',
-    description: '벡터 DB의 문서와 메타데이터를 JSON 파일로 내보냅니다. 다른 도구로 이전 가능.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            outputPath: { type: 'string', description: '출력 파일 경로 (예: ./export.json)' },
-            format: { type: 'string', enum: ['json', 'csv'], description: '출력 포맷 (기본: json)' },
-        },
-        required: ['outputPath'],
-    },
-};
-export async function handleExport(store, args) {
-    const docs = await store.getAllDocuments();
-    const stats = await store.getStats();
-    const topics = await store.getTopics();
-    const safePath = validateExportPath(args.outputPath);
-    mkdirSync(dirname(safePath), { recursive: true });
-    if (args.format === 'csv') {
-        const header = 'id,filePath,title,tags,lastModified,contentHash';
-        const rows = docs.map(d => `"${d.id}","${d.filePath}","${d.title.replace(/"/g, '""')}","${d.tags.join(';')}","${d.lastModified}","${d.contentHash}"`);
-        writeFileSync(safePath, [header, ...rows].join('\n'), 'utf-8');
-    }
-    else {
-        const exported = {
-            exportedAt: new Date().toISOString(),
-            version: '1.0',
-            stats,
-            topics,
-            documents: docs.map(d => ({
-                id: d.id,
-                filePath: d.filePath,
-                title: d.title,
-                tags: d.tags,
-                frontmatter: d.frontmatter,
-                lastModified: d.lastModified,
-                contentLength: d.content.length,
-            })),
-        };
-        writeFileSync(safePath, JSON.stringify(exported, null, 2), 'utf-8');
-    }
-    return { exported: docs.length, path: safePath, format: args.format ?? 'json' };
-}
-//# sourceMappingURL=export.js.map

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

@@ -1,29 +0,0 @@
-import type { FederatedSearch } from '../../federation/search.js';
-export declare function createFederatedSearchTool(federatedSearch: FederatedSearch | null): {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-    handler(args: {
-        query: string;
-        limit?: number;
-    }): Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-    }>;
-};
-//# sourceMappingURL=federated-search.d.ts.map

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

@@ -1,36 +0,0 @@
-// MCP Tool: federated-search (Federation Phase 1b)
-// AI 에이전트가 연합 네트워크를 검색
-export function createFederatedSearchTool(federatedSearch) {
-    return {
-        name: 'federated-search',
-        description: 'Search across all connected Federation peers. Returns results from other Stellavault nodes in the P2P network. Only titles, similarity scores, and 50-char snippets are shared — no raw text leaves any node.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                query: { type: 'string', description: 'Search query' },
-                limit: { type: 'number', description: 'Max results per peer (default: 5)' },
-            },
-            required: ['query'],
-        },
-        async handler(args) {
-            if (!federatedSearch) {
-                return { content: [{ type: 'text', text: 'Federation not active. Run `sv federate join` first.' }] };
-            }
-            const results = await federatedSearch.search(args.query, { limit: args.limit ?? 5 });
-            if (results.length === 0) {
-                return { content: [{ type: 'text', text: 'No results from federation peers. Either no peers connected or no matching documents.' }] };
-            }
-            const lines = [
-                `🌐 Federation Search: "${args.query}" — ${results.length} results from ${new Set(results.map(r => r.peerId)).size} peers`,
-                '',
-            ];
-            for (const r of results) {
-                lines.push(`**${r.title}** (${Math.round(r.similarity * 100)}%) [${r.peerName}]`);
-                lines.push(`  ${r.snippet}...`);
-                lines.push('');
-            }
-            return { content: [{ type: 'text', text: lines.join('\n') }] };
-        },
-    };
-}
-//# sourceMappingURL=federated-search.js.map

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

@@ -1,35 +0,0 @@
-import type { SearchEngine } from '../../search/index.js';
-import type { VectorStore } from '../../store/types.js';
-export declare const generateClaudeMdToolDef: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            projectName: {
-                type: string;
-                description: string;
-            };
-            topics: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleGenerateClaudeMd(searchEngine: SearchEngine, store: VectorStore, args: {
-    projectName: string;
-    topics?: string[];
-}): Promise<{
-    content: string;
-    stats: {
-        queriesRun: number;
-        uniqueResults: number;
-        sections: string[];
-    };
-}>;
-//# sourceMappingURL=generate-claude-md.d.ts.map

package/packages/core/dist/mcp/tools/generate-claude-md.js

@@ -1,107 +0,0 @@
-// Design Ref: §12.1 F13 — CLAUDE.md 자동 생성기 (킬러 유스케이스)
-export const generateClaudeMdToolDef = {
-    name: 'generate-claude-md',
-    description: '프로젝트명을 기반으로 관련 지식(아키텍처, 패턴, 교훈, 결정사항)을 검색하여 CLAUDE.md 초안을 자동 생성합니다.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            projectName: { type: 'string', description: '프로젝트명 또는 주요 키워드' },
-            topics: {
-                type: 'array',
-                items: { type: 'string' },
-                description: '추가 검색할 토픽 (예: ["인증", "배포", "성능"])',
-            },
-        },
-        required: ['projectName'],
-    },
-};
-export async function handleGenerateClaudeMd(searchEngine, store, args) {
-    const { projectName, topics = [] } = args;
-    // 프로젝트 관련 지식 검색 (여러 관점)
-    const queries = [
-        `${projectName} 아키텍처 설계`,
-        `${projectName} 패턴 컨벤션`,
-        `${projectName} 교훈 실수 주의사항`,
-        `${projectName} 기술 스택 의존성`,
-        ...topics.map(t => `${projectName} ${t}`),
-    ];
-    const allResults = new Map();
-    for (const query of queries) {
-        const results = await searchEngine.search({ query, limit: 3 });
-        const category = query.replace(projectName, '').trim();
-        for (const r of results) {
-            const key = r.chunk.id;
-            if (!allResults.has(key) || (allResults.get(key).score < r.score)) {
-                allResults.set(key, {
-                    title: `${r.document.title} §${r.chunk.heading}`,
-                    content: r.chunk.content.slice(0, 500),
-                    score: r.score,
-                    category,
-                });
-            }
-        }
-    }
-    // 카테고리별 분류
-    const sorted = [...allResults.values()].sort((a, b) => b.score - a.score);
-    // CLAUDE.md 초안 생성
-    const sections = [];
-    sections.push(`# ${projectName} — CLAUDE.md`);
-    sections.push('');
-    sections.push('> 이 파일은 evan-knowledge-hub MCP에서 자동 생성되었습니다.');
-    sections.push(`> 생성일: ${new Date().toISOString().slice(0, 10)}`);
-    sections.push(`> 참조 지식: ${sorted.length}건`);
-    sections.push('');
-    // 아키텍처 섹션
-    const archResults = sorted.filter(r => r.category.includes('아키텍처') || r.category.includes('설계'));
-    if (archResults.length > 0) {
-        sections.push('## 아키텍처 & 설계');
-        sections.push('');
-        for (const r of archResults.slice(0, 3)) {
-            sections.push(`### ${r.title}`);
-            sections.push(r.content.trim());
-            sections.push('');
-        }
-    }
-    // 패턴/컨벤션 섹션
-    const patternResults = sorted.filter(r => r.category.includes('패턴') || r.category.includes('컨벤션'));
-    if (patternResults.length > 0) {
-        sections.push('## 코딩 패턴 & 컨벤션');
-        sections.push('');
-        for (const r of patternResults.slice(0, 3)) {
-            sections.push(`### ${r.title}`);
-            sections.push(r.content.trim());
-            sections.push('');
-        }
-    }
-    // 교훈 섹션
-    const lessonResults = sorted.filter(r => r.category.includes('교훈') || r.category.includes('실수'));
-    if (lessonResults.length > 0) {
-        sections.push('## 교훈 & 주의사항');
-        sections.push('');
-        for (const r of lessonResults.slice(0, 5)) {
-            sections.push(`- **${r.title}**: ${r.content.slice(0, 200).replace(/\n/g, ' ').trim()}`);
-        }
-        sections.push('');
-    }
-    // 기타 관련 지식
-    const otherResults = sorted.filter(r => !r.category.includes('아키텍처') && !r.category.includes('설계') &&
-        !r.category.includes('패턴') && !r.category.includes('교훈') && !r.category.includes('실수'));
-    if (otherResults.length > 0) {
-        sections.push('## 관련 지식');
-        sections.push('');
-        for (const r of otherResults.slice(0, 5)) {
-            sections.push(`- **${r.title}** (score: ${r.score.toFixed(3)})`);
-        }
-        sections.push('');
-    }
-    const claudeMd = sections.join('\n');
-    return {
-        content: claudeMd,
-        stats: {
-            queriesRun: queries.length,
-            uniqueResults: sorted.length,
-            sections: ['아키텍처', '패턴', '교훈', '관련 지식'].filter((_, i) => [archResults, patternResults, lessonResults, otherResults][i].length > 0),
-        },
-    };
-}
-//# sourceMappingURL=generate-claude-md.js.map

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

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