stellavault 0.1.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stellavault",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Turn your Obsidian vault into a 3D neural knowledge graph with AI-powered search, memory decay tracking, and MCP integration.",
   "repository": {
     "type": "git",

package/packages/cli/bin/ekh.js

@@ -1,2 +1,2 @@
-#!/usr/bin/env node
-import '../dist/index.js';
+#!/usr/bin/env node
+import '../dist/index.js';

package/packages/cli/dist/commands/federate-cmd.js

@@ -2,7 +2,7 @@
 // Plan SC: SC1-SC5
 import { createInterface } from 'node:readline';
 import chalk from 'chalk';
-import { loadConfig, createSqliteVecStore, createLocalEmbedder, FederationNode, FederatedSearch, getOrCreateIdentity, getSharingSummary, addBlockedTag, removeBlockedTag, addBlockedFolder, loadSharingConfig, saveSharingConfig, } from '@stellavault/core';
+import { loadConfig, createSqliteVecStore, createLocalEmbedder, FederationNode, FederatedSearch, getOrCreateIdentity, getSharingSummary, setTagLevel, setFolderLevel, setNodeLevel, getPendingRequests, approveRequest, denyRequest, } from '@stellavault/core';
 export async function federateJoinCommand(options) {
     const config = loadConfig();
     const identity = getOrCreateIdentity(options.name);
@@ -118,46 +118,74 @@ export async function federateJoinCommand(options) {
                 console.log('');
                 break;
             }
-            case 'block-tag': {
+            case 'set-tag': {
                 const tag = parts[1];
-                if (!tag) {
-                    console.log(chalk.yellow('  Usage: block-tag <tag>'));
+                const lvl = parseInt(parts[2], 10);
+                if (!tag || isNaN(lvl) || lvl < 0 || lvl > 4) {
+                    console.log(chalk.yellow('  Usage: set-tag <tag> <0-4>'));
                     break;
                 }
-                addBlockedTag(tag);
-                console.log(chalk.green(`  Blocked tag: #${tag}`));
+                setTagLevel(tag, lvl);
+                console.log(chalk.green(`  #${tag} → Level ${lvl}`));
                 break;
             }
-            case 'unblock-tag': {
-                const tag = parts[1];
-                if (!tag) {
-                    console.log(chalk.yellow('  Usage: unblock-tag <tag>'));
+            case 'set-folder': {
+                const folder = parts[1];
+                const lvl = parseInt(parts[2], 10);
+                if (!folder || isNaN(lvl) || lvl < 0 || lvl > 4) {
+                    console.log(chalk.yellow('  Usage: set-folder <folder> <0-4>'));
                     break;
                 }
-                removeBlockedTag(tag);
-                console.log(chalk.green(`  Unblocked tag: #${tag}`));
+                setFolderLevel(folder, lvl);
+                console.log(chalk.green(`  ${folder} → Level ${lvl}`));
                 break;
             }
-            case 'block-folder': {
-                const folder = parts[1];
-                if (!folder) {
-                    console.log(chalk.yellow('  Usage: block-folder <folder>'));
+            case 'set-level': {
+                const lvl = parseInt(parts[1], 10);
+                if (isNaN(lvl) || lvl < 0 || lvl > 4) {
+                    console.log(chalk.yellow('  Usage: set-level <0-4> (your node sharing level)'));
+                    break;
+                }
+                setNodeLevel(lvl);
+                console.log(chalk.green(`  My node level → ${lvl}`));
+                break;
+            }
+            case 'requests': {
+                const pending = getPendingRequests();
+                if (pending.length === 0) {
+                    console.log(chalk.dim('  No pending requests'));
+                    break;
+                }
+                console.log(`\n  ${pending.length} pending full-text requests:`);
+                for (const r of pending) {
+                    console.log(`  ${r.requestId.slice(0, 8)} — "${r.documentTitle}" from ${r.fromName} (${r.requestedAt.slice(0, 10)})`);
+                }
+                break;
+            }
+            case 'approve': {
+                const reqId = parts[1];
+                if (!reqId) {
+                    console.log(chalk.yellow('  Usage: approve <request-id>'));
                     break;
                 }
-                addBlockedFolder(folder);
-                console.log(chalk.green(`  Blocked folder: ${folder}`));
+                const match = getPendingRequests().find(r => r.requestId.startsWith(reqId));
+                if (match && approveRequest(match.requestId))
+                    console.log(chalk.green(`  Approved: ${match.documentTitle}`));
+                else
+                    console.log(chalk.red('  Request not found'));
                 break;
             }
-            case 'mode': {
-                const mode = parts[1];
-                if (mode !== 'whitelist' && mode !== 'blacklist') {
-                    console.log(chalk.yellow('  Usage: mode whitelist|blacklist'));
+            case 'deny': {
+                const reqId = parts[1];
+                if (!reqId) {
+                    console.log(chalk.yellow('  Usage: deny <request-id>'));
                     break;
                 }
-                const cfg = loadSharingConfig();
-                cfg.mode = mode;
-                saveSharingConfig(cfg);
-                console.log(chalk.green(`  Sharing mode: ${mode}`));
+                const match = getPendingRequests().find(r => r.requestId.startsWith(reqId));
+                if (match && denyRequest(match.requestId))
+                    console.log(chalk.green(`  Denied: ${match.documentTitle}`));
+                else
+                    console.log(chalk.red('  Request not found'));
                 break;
             }
             case 'leave':
@@ -177,11 +205,13 @@ export async function federateJoinCommand(options) {
                 console.log(`    ${chalk.cyan('peers')}             List connected peers`);
                 console.log(`    ${chalk.cyan('status')}            Show node info`);
                 console.log(`    ${chalk.cyan('connect <ip:port>')} Connect to peer directly`);
-                console.log(`    ${chalk.cyan('sharing')}           Show sharing settings`);
-                console.log(`    ${chalk.cyan('block-tag <tag>')}   Block a tag from sharing`);
-                console.log(`    ${chalk.cyan('unblock-tag <tag>')} Unblock a tag`);
-                console.log(`    ${chalk.cyan('block-folder <f>')}  Block a folder from sharing`);
-                console.log(`    ${chalk.cyan('mode <wl|bl>')}      Set whitelist or blacklist mode`);
+                console.log(`    ${chalk.cyan('sharing')}              Show sharing settings`);
+                console.log(`    ${chalk.cyan('set-tag <t> <0-4>')}   Set tag sharing level`);
+                console.log(`    ${chalk.cyan('set-folder <f> <0-4>')} Set folder sharing level`);
+                console.log(`    ${chalk.cyan('set-level <0-4>')}     Set your node level`);
+                console.log(`    ${chalk.cyan('requests')}            Show pending full-text requests`);
+                console.log(`    ${chalk.cyan('approve <id>')}        Approve a request`);
+                console.log(`    ${chalk.cyan('deny <id>')}           Deny a request`);
                 console.log(`    ${chalk.cyan('leave')}             Disconnect and exit`);
                 break;
             }

package/packages/core/dist/api/dashboard.d.ts

@@ -0,0 +1,3 @@
+import type { Express } from 'express';
+export declare function mountDashboard(app: Express): void;
+//# sourceMappingURL=dashboard.d.ts.map

package/packages/core/{src/api/dashboard.ts → dist/api/dashboard.js}

@@ -1,17 +1,13 @@
 // Web Dashboard (P3-F26) — Express에 HTML 대시보드 추가
 // http://localhost:3333/dashboard
-
-import type { Express } from 'express';
-
-export function mountDashboard(app: Express) {
-  app.get('/dashboard', (_req, res) => {
-    res.setHeader('Content-Type', 'text/html');
-    res.send(getDashboardHTML());
-  });
+export function mountDashboard(app) {
+    app.get('/dashboard', (_req, res) => {
+        res.setHeader('Content-Type', 'text/html');
+        res.send(getDashboardHTML());
+    });
 }
-
-function getDashboardHTML(): string {
-  return `<!DOCTYPE html>
+function getDashboardHTML() {
+    return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
@@ -136,3 +132,4 @@ function getDashboardHTML(): string {
 </body>
 </html>`;
 }
+//# sourceMappingURL=dashboard.js.map

package/packages/core/dist/api/graph-data.d.ts

@@ -0,0 +1,11 @@
+import type { VectorStore } from '../store/types.js';
+import type { GraphData } from '../types/graph.js';
+export type GraphMode = 'semantic' | 'folder';
+export interface BuildGraphOptions {
+    mode?: GraphMode;
+    edgeThreshold?: number;
+    maxEdgesPerNode?: number;
+    clusterCount?: number;
+}
+export declare function buildGraphData(store: VectorStore, options?: BuildGraphOptions): Promise<GraphData>;
+//# sourceMappingURL=graph-data.d.ts.map

package/packages/core/dist/api/graph-data.js

@@ -0,0 +1,255 @@
+// Design Ref: §4.2 — Graph Data 생성 알고리즘
+// Design Ref: §6.2 — K-Means 클러스터링
+import { createHash } from 'node:crypto';
+const CLUSTER_COLORS = [
+    '#6366f1', '#ec4899', '#f59e0b', '#10b981', '#3b82f6',
+    '#8b5cf6', '#ef4444', '#14b8a6', '#f97316', '#06b6d4',
+    '#84cc16', '#e879f9', '#22d3ee', '#a3e635', '#fb923c',
+];
+export async function buildGraphData(store, options = {}) {
+    const { edgeThreshold = 0.15, maxEdgesPerNode = 5, } = options;
+    // 1. 모든 문서 + 임베딩 로드
+    const [docs, embeddings] = await Promise.all([
+        store.getAllDocuments(),
+        store.getDocumentEmbeddings(),
+    ]);
+    // 2. k-NN으로 엣지 생성
+    const edges = [];
+    const edgeCounts = new Map();
+    for (const doc of docs) {
+        const vec = embeddings.get(doc.id);
+        if (!vec)
+            continue;
+        // 모든 다른 문서와 코사인 유사도 계산
+        const similarities = [];
+        for (const other of docs) {
+            if (other.id === doc.id)
+                continue;
+            const otherVec = embeddings.get(other.id);
+            if (!otherVec)
+                continue;
+            const sim = cosineSimilarity(vec, otherVec);
+            if (sim >= edgeThreshold) {
+                similarities.push({ id: other.id, sim });
+            }
+        }
+        // 상위 k개만
+        similarities.sort((a, b) => b.sim - a.sim);
+        const topK = similarities.slice(0, maxEdgesPerNode);
+        for (const { id: targetId, sim } of topK) {
+            // 중복 엣지 방지 (A→B, B→A)
+            const edgeKey = [doc.id, targetId].sort().join(':');
+            if (!edgeCounts.has(edgeKey)) {
+                edges.push({ source: doc.id, target: targetId, weight: sim });
+                edgeCounts.set(edgeKey, 1);
+            }
+        }
+    }
+    // 3. 클러스터링 — 모드에 따라 분기
+    const mode = options.mode ?? 'semantic';
+    let assignmentMap;
+    let clusters;
+    if (mode === 'folder') {
+        // 폴더 기반: 최상위 폴더를 클러스터로 사용
+        const folderMap = new Map();
+        const folderNames = [];
+        for (const doc of docs) {
+            const topFolder = doc.filePath.split('/')[0] ?? 'root';
+            if (!folderMap.has(topFolder)) {
+                folderMap.set(topFolder, folderNames.length);
+                folderNames.push(topFolder);
+            }
+        }
+        assignmentMap = new Map();
+        for (const doc of docs) {
+            const topFolder = doc.filePath.split('/')[0] ?? 'root';
+            assignmentMap.set(doc.id, folderMap.get(topFolder));
+        }
+        // 폴더별 클러스터
+        const folderCounts = new Map();
+        for (const [, cId] of assignmentMap) {
+            folderCounts.set(cId, (folderCounts.get(cId) ?? 0) + 1);
+        }
+        clusters = folderNames.map((name, i) => ({
+            id: i,
+            label: name.replace(/^\d+_/, ''), // "04_Projects" → "Projects"
+            color: CLUSTER_COLORS[i % CLUSTER_COLORS.length],
+            nodeCount: folderCounts.get(i) ?? 0,
+        }));
+    }
+    else {
+        // 시맨틱 기반: K-means
+        const docIds = docs.filter(d => embeddings.has(d.id)).map(d => d.id);
+        const vectors = docIds.map(id => embeddings.get(id));
+        const k = Math.min(Math.max(5, Math.round(Math.sqrt(docIds.length / 5))), 10);
+        const assignments = kMeans(vectors, k);
+        // 클러스터별 문서 수집 (id + title)
+        const clusterDocInfos = new Map();
+        for (let i = 0; i < docIds.length; i++) {
+            const cId = assignments[i];
+            if (!clusterDocInfos.has(cId))
+                clusterDocInfos.set(cId, []);
+            const doc = docs.find(d => d.id === docIds[i]);
+            if (doc)
+                clusterDocInfos.get(cId).push({ id: doc.id, title: doc.title });
+        }
+        // 엣지 기반 연결 수 계산 (대표 노드 선정용)
+        const connCounts = new Map();
+        for (const e of edges) {
+            connCounts.set(e.source, (connCounts.get(e.source) ?? 0) + 1);
+            connCounts.set(e.target, (connCounts.get(e.target) ?? 0) + 1);
+        }
+        clusters = [];
+        for (const [cId, docInfos] of clusterDocInfos) {
+            // 가장 연결이 많은 노드 = 대표 노드
+            const sorted = [...docInfos].sort((a, b) => (connCounts.get(b.id) ?? 0) - (connCounts.get(a.id) ?? 0));
+            const representative = sorted[0]?.title ?? 'Cluster';
+            clusters.push({
+                id: cId,
+                label: `${representative} (${docInfos.length})`,
+                color: CLUSTER_COLORS[cId % CLUSTER_COLORS.length],
+                nodeCount: docInfos.length,
+            });
+        }
+        assignmentMap = new Map();
+        for (let i = 0; i < docIds.length; i++) {
+            assignmentMap.set(docIds[i], assignments[i]);
+        }
+    }
+    // 4. 노드 생성
+    const connectionCounts = new Map();
+    for (const edge of edges) {
+        connectionCounts.set(edge.source, (connectionCounts.get(edge.source) ?? 0) + 1);
+        connectionCounts.set(edge.target, (connectionCounts.get(edge.target) ?? 0) + 1);
+    }
+    const maxConnections = Math.max(1, ...connectionCounts.values());
+    const nodes = docs.map(doc => {
+        const conns = connectionCounts.get(doc.id) ?? 0;
+        const ratio = conns / maxConnections; // 0~1
+        // 지수 스케일: 상위 노드만 극적으로 커짐 (ratio^0.5 → 중심부 강조)
+        const size = 1 + 6 * Math.pow(ratio, 0.5);
+        return {
+            id: doc.id,
+            label: doc.title.slice(0, 40),
+            filePath: doc.filePath,
+            tags: doc.tags,
+            clusterId: assignmentMap.get(doc.id) ?? 0,
+            size,
+            source: doc.source ?? 'local',
+            type: doc.type ?? 'note',
+            lastModified: doc.lastModified,
+        };
+    });
+    // 5. cache key
+    const cacheKey = createHash('md5')
+        .update(JSON.stringify({ nodeCount: nodes.length, edgeCount: edges.length }))
+        .digest('hex')
+        .slice(0, 8);
+    return {
+        nodes,
+        edges,
+        clusters,
+        stats: {
+            nodeCount: nodes.length,
+            edgeCount: edges.length,
+            clusterCount: clusters.length,
+        },
+    };
+}
+// --- 유틸리티 ---
+function cosineSimilarity(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+function kMeans(vectors, k, maxIter = 50) {
+    if (vectors.length === 0)
+        return [];
+    const dims = vectors[0].length;
+    // K-means++ 초기화
+    const centroids = [vectors[Math.floor(Math.random() * vectors.length)].slice()];
+    for (let c = 1; c < k; c++) {
+        const dists = vectors.map(v => {
+            let minD = Infinity;
+            for (const cent of centroids) {
+                const d = euclideanDist(v, cent);
+                if (d < minD)
+                    minD = d;
+            }
+            return minD;
+        });
+        const totalDist = dists.reduce((a, b) => a + b, 0);
+        let r = Math.random() * totalDist;
+        for (let i = 0; i < dists.length; i++) {
+            r -= dists[i];
+            if (r <= 0) {
+                centroids.push(vectors[i].slice());
+                break;
+            }
+        }
+        if (centroids.length <= c)
+            centroids.push(vectors[Math.floor(Math.random() * vectors.length)].slice());
+    }
+    const assignments = new Array(vectors.length).fill(0);
+    for (let iter = 0; iter < maxIter; iter++) {
+        let changed = false;
+        // Assign
+        for (let i = 0; i < vectors.length; i++) {
+            let bestC = 0, bestD = Infinity;
+            for (let c = 0; c < k; c++) {
+                const d = euclideanDist(vectors[i], centroids[c]);
+                if (d < bestD) {
+                    bestD = d;
+                    bestC = c;
+                }
+            }
+            if (assignments[i] !== bestC) {
+                assignments[i] = bestC;
+                changed = true;
+            }
+        }
+        if (!changed)
+            break;
+        // Update centroids
+        for (let c = 0; c < k; c++) {
+            const members = vectors.filter((_, i) => assignments[i] === c);
+            if (members.length === 0)
+                continue;
+            for (let d = 0; d < dims; d++) {
+                centroids[c][d] = members.reduce((sum, v) => sum + v[d], 0) / members.length;
+            }
+        }
+    }
+    return assignments;
+}
+function euclideanDist(a, b) {
+    let sum = 0;
+    for (let i = 0; i < a.length; i++) {
+        const diff = a[i] - b[i];
+        sum += diff * diff;
+    }
+    return Math.sqrt(sum);
+}
+function extractClusterLabel(titles) {
+    // 제목에서 빈출 단어 추출 (2글자 이상)
+    const wordCounts = new Map();
+    const stopWords = new Set(['the', 'a', 'an', 'in', 'on', 'at', 'to', 'for', 'of', 'and', 'or', 'is', 'are', 'was', 'be']);
+    for (const title of titles) {
+        const words = title.replace(/[^\w가-힣\s]/g, '').split(/\s+/).filter(w => w.length >= 2 && !stopWords.has(w.toLowerCase()));
+        const seen = new Set();
+        for (const w of words) {
+            if (!seen.has(w)) {
+                wordCounts.set(w, (wordCounts.get(w) ?? 0) + 1);
+                seen.add(w);
+            }
+        }
+    }
+    const sorted = [...wordCounts.entries()].sort((a, b) => b[1] - a[1]);
+    return sorted.slice(0, 3).map(([w]) => w).join(', ') || `Cluster`;
+}
+//# sourceMappingURL=graph-data.js.map

package/packages/core/dist/api/pwa.d.ts

@@ -0,0 +1,3 @@
+import type { Express } from 'express';
+export declare function mountPWA(app: Express): void;
+//# sourceMappingURL=pwa.d.ts.map

package/packages/core/{src/api/pwa.ts → dist/api/pwa.js}

@@ -1,39 +1,33 @@
 // Mobile PWA (P3-F27) — 서비스 워커 + PWA manifest 제공
 // Express에 PWA 지원 추가
-
-import type { Express } from 'express';
-
-export function mountPWA(app: Express) {
-  // PWA Manifest
-  app.get('/manifest.json', (_req, res) => {
-    res.json({
-      name: 'Stellavault',
-      short_name: 'SV',
-      description: 'Your knowledge, alive.',
-      start_url: '/dashboard',
-      display: 'standalone',
-      background_color: '#050510',
-      theme_color: '#6366f1',
-      icons: [
-        { src: '/icon-192.png', sizes: '192x192', type: 'image/png' },
-        { src: '/icon-512.png', sizes: '512x512', type: 'image/png' },
-      ],
+export function mountPWA(app) {
+    // PWA Manifest
+    app.get('/manifest.json', (_req, res) => {
+        res.json({
+            name: 'Stellavault',
+            short_name: 'SV',
+            description: 'Your knowledge, alive.',
+            start_url: '/dashboard',
+            display: 'standalone',
+            background_color: '#050510',
+            theme_color: '#6366f1',
+            icons: [
+                { src: '/icon-192.png', sizes: '192x192', type: 'image/png' },
+                { src: '/icon-512.png', sizes: '512x512', type: 'image/png' },
+            ],
+        });
     });
-  });
-
-  // Service Worker
-  app.get('/sw.js', (_req, res) => {
-    res.setHeader('Content-Type', 'application/javascript');
-    res.send(getServiceWorkerJS());
-  });
-
-  // SVG icon fallback (no PNG needed for MVP)
-  app.get('/icon-192.png', (_req, res) => { res.redirect('/api/profile-card'); });
-  app.get('/icon-512.png', (_req, res) => { res.redirect('/api/profile-card'); });
+    // Service Worker
+    app.get('/sw.js', (_req, res) => {
+        res.setHeader('Content-Type', 'application/javascript');
+        res.send(getServiceWorkerJS());
+    });
+    // SVG icon fallback (no PNG needed for MVP)
+    app.get('/icon-192.png', (_req, res) => { res.redirect('/api/profile-card'); });
+    app.get('/icon-512.png', (_req, res) => { res.redirect('/api/profile-card'); });
 }
-
-function getServiceWorkerJS(): string {
-  return `
+function getServiceWorkerJS() {
+    return `
 const CACHE_NAME = 'stellavault-v1';
 const STATIC_ASSETS = ['/dashboard', '/manifest.json'];
 
@@ -80,3 +74,4 @@ self.addEventListener('fetch', (event) => {
 });
 `.trim();
 }
+//# sourceMappingURL=pwa.js.map

package/packages/core/dist/api/server.d.ts

@@ -0,0 +1,16 @@
+import type { VectorStore } from '../store/types.js';
+import type { SearchEngine } from '../search/index.js';
+import type { DecayEngine } from '../intelligence/decay-engine.js';
+export interface ApiServerOptions {
+    store: VectorStore;
+    searchEngine: SearchEngine;
+    port?: number;
+    vaultName?: string;
+    vaultPath?: string;
+    decayEngine?: DecayEngine;
+}
+export declare function createApiServer(options: ApiServerOptions): {
+    start(): Promise<void>;
+    app: import("express-serve-static-core").Express;
+};
+//# sourceMappingURL=server.d.ts.map