stellavault 0.4.4 → 0.5.0

package/packages/core/dist/store/types.d.ts

@@ -1,20 +0,0 @@
-import type { Chunk, ScoredChunk, Document, TopicInfo, StoreStats } from '../types/index.js';
-export interface VectorStore {
-    initialize(): Promise<void>;
-    upsertDocument(doc: Document): Promise<void>;
-    upsertChunks(chunks: Chunk[]): Promise<void>;
-    deleteByDocumentId(documentId: string): Promise<void>;
-    searchSemantic(embedding: number[], limit: number): Promise<ScoredChunk[]>;
-    searchKeyword(query: string, limit: number): Promise<ScoredChunk[]>;
-    getDocument(documentId: string): Promise<Document | null>;
-    getChunk(chunkId: string): Promise<Chunk | null>;
-    getAllDocuments(): Promise<Document[]>;
-    getTopics(): Promise<TopicInfo[]>;
-    getStats(): Promise<StoreStats>;
-    /** 각 문서의 첫 청크 임베딩 반환 (graph용) */
-    getDocumentEmbeddings(): Promise<Map<string, number[]>>;
-    close(): Promise<void>;
-    /** 내부 DB 인스턴스 접근 (Intelligence Layer용) */
-    getDb(): unknown;
-}
-//# sourceMappingURL=types.d.ts.map

package/packages/core/dist/store/types.js

@@ -1,3 +0,0 @@
-// Design Ref: §3.2 — 교체 가능 설계 (VectorStore 인터페이스)
-export {};
-//# sourceMappingURL=types.js.map

package/packages/core/dist/team/index.d.ts

@@ -1,25 +0,0 @@
-export type TeamRole = 'admin' | 'editor' | 'viewer';
-export interface TeamMember {
-    token: string;
-    tokenHash: string;
-    displayName: string;
-    role: TeamRole;
-    createdAt: string;
-    lastAccess?: string;
-}
-export interface TeamConfig {
-    teamName: string;
-    members: TeamMember[];
-}
-export declare function loadTeamConfig(): TeamConfig;
-export declare function generateToken(): string;
-export declare function inviteMember(displayName: string, role?: TeamRole): {
-    token: string;
-    member: TeamMember;
-};
-export declare function authenticateMember(token: string): TeamMember | null;
-export declare function hasPermission(member: TeamMember, action: 'read' | 'write' | 'admin'): boolean;
-export declare function listMembers(): TeamMember[];
-export declare function removeMember(displayName: string): boolean;
-export declare function createAuthMiddleware(): (req: any, res: any, next: any) => any;
-//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/team/index.js

@@ -1,97 +0,0 @@
-// Team Vault (F-A06) — Bearer 토큰 인증 + RBAC
-// MCP Streamable HTTP에 인증 레이어 추가
-import { randomBytes, createHash } from 'node:crypto';
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
-import { join } from 'node:path';
-import { homedir } from 'node:os';
-const TEAM_DIR = join(homedir(), '.stellavault', 'team');
-const TEAM_FILE = join(TEAM_DIR, 'team.json');
-export function loadTeamConfig() {
-    if (existsSync(TEAM_FILE)) {
-        return JSON.parse(readFileSync(TEAM_FILE, 'utf-8'));
-    }
-    return { teamName: 'My Team', members: [] };
-}
-function saveTeamConfig(config) {
-    mkdirSync(TEAM_DIR, { recursive: true });
-    writeFileSync(TEAM_FILE, JSON.stringify(config, null, 2), 'utf-8');
-}
-// 토큰 생성
-export function generateToken() {
-    return `sv_${randomBytes(24).toString('hex')}`;
-}
-function hashToken(token) {
-    return createHash('sha256').update(token).digest('hex');
-}
-// 멤버 초대 → 토큰 반환
-export function inviteMember(displayName, role = 'viewer') {
-    const config = loadTeamConfig();
-    const token = generateToken();
-    const member = {
-        token: '', // 클리어 토큰은 저장 안 함
-        tokenHash: hashToken(token),
-        displayName,
-        role,
-        createdAt: new Date().toISOString(),
-    };
-    config.members.push(member);
-    saveTeamConfig(config);
-    return { token, member }; // 토큰은 이때만 보여줌
-}
-// 토큰으로 멤버 인증
-export function authenticateMember(token) {
-    const config = loadTeamConfig();
-    const hash = hashToken(token);
-    const member = config.members.find(m => m.tokenHash === hash);
-    if (member) {
-        member.lastAccess = new Date().toISOString();
-        saveTeamConfig(config);
-    }
-    return member ?? null;
-}
-// RBAC 권한 확인
-export function hasPermission(member, action) {
-    switch (action) {
-        case 'read': return true; // 모든 역할 읽기 가능
-        case 'write': return member.role === 'admin' || member.role === 'editor';
-        case 'admin': return member.role === 'admin';
-    }
-}
-// 멤버 목록
-export function listMembers() {
-    return loadTeamConfig().members;
-}
-// 멤버 제거
-export function removeMember(displayName) {
-    const config = loadTeamConfig();
-    const before = config.members.length;
-    config.members = config.members.filter(m => m.displayName !== displayName);
-    if (config.members.length < before) {
-        saveTeamConfig(config);
-        return true;
-    }
-    return false;
-}
-// Express 미들웨어: Bearer 토큰 인증
-export function createAuthMiddleware() {
-    return (req, res, next) => {
-        const authHeader = req.headers.authorization;
-        if (!authHeader?.startsWith('Bearer ')) {
-            // HIGH-01: localhost는 editor 권한만 (admin은 토큰 필수)
-            const ip = req.ip || req.connection?.remoteAddress;
-            if (ip === '127.0.0.1' || ip === '::1' || ip === '::ffff:127.0.0.1') {
-                req.teamMember = { displayName: 'local', role: 'editor' };
-                return next();
-            }
-            return res.status(401).json({ error: 'Bearer token required' });
-        }
-        const token = authHeader.slice(7);
-        const member = authenticateMember(token);
-        if (!member) {
-            return res.status(403).json({ error: 'Invalid token' });
-        }
-        req.teamMember = member;
-        next();
-    };
-}
-//# sourceMappingURL=index.js.map

package/packages/core/dist/types/chunk.d.ts

@@ -1,23 +0,0 @@
-export interface Chunk {
-    /** document.id + "#" + chunkIndex */
-    id: string;
-    /** 소속 문서 ID */
-    documentId: string;
-    /** 청크 텍스트 */
-    content: string;
-    /** 소속 heading (## 제목) */
-    heading: string;
-    /** 원문 시작 줄 번호 */
-    startLine: number;
-    /** 원문 끝 줄 번호 */
-    endLine: number;
-    /** 토큰 수 */
-    tokenCount: number;
-    /** 768차원 벡터 (로딩 시 선택적) */
-    embedding?: number[];
-}
-export interface ScoredChunk {
-    chunkId: string;
-    score: number;
-}
-//# sourceMappingURL=chunk.d.ts.map

package/packages/core/dist/types/chunk.js

@@ -1,3 +0,0 @@
-// Design Ref: §3.1 — Core Types (Chunk)
-export {};
-//# sourceMappingURL=chunk.js.map

package/packages/core/dist/types/document.d.ts

@@ -1,23 +0,0 @@
-export interface Document {
-    /** SHA-256 hash of file path */
-    id: string;
-    /** vault 기준 상대 경로 */
-    filePath: string;
-    /** frontmatter title 또는 첫 heading */
-    title: string;
-    /** 전체 마크다운 텍스트 */
-    content: string;
-    /** YAML frontmatter */
-    frontmatter: Record<string, unknown>;
-    /** #태그 목록 */
-    tags: string[];
-    /** ISO 8601 */
-    lastModified: string;
-    /** SHA-256 of content (증분 인덱싱용) */
-    contentHash: string;
-    /** 출처: local | notion | clip | bridge | pack */
-    source?: string;
-    /** 노트 유형: note | clip | sync | bridge | decision | snapshot */
-    type?: string;
-}
-//# sourceMappingURL=document.d.ts.map

package/packages/core/dist/types/document.js

@@ -1,3 +0,0 @@
-// Design Ref: §3.1 — Core Types (Document)
-export {};
-//# sourceMappingURL=document.js.map

package/packages/core/dist/types/graph.d.ts

@@ -1,39 +0,0 @@
-export interface GraphNode {
-    id: string;
-    label: string;
-    filePath: string;
-    tags: string[];
-    clusterId: number;
-    position?: [number, number, number];
-    size: number;
-    source?: string;
-    type?: string;
-    lastModified?: string;
-}
-export interface GraphEdge {
-    source: string;
-    target: string;
-    weight: number;
-}
-export interface Cluster {
-    id: number;
-    label: string;
-    color: string;
-    nodeCount: number;
-}
-export interface GraphData {
-    nodes: GraphNode[];
-    edges: GraphEdge[];
-    clusters: Cluster[];
-    stats: {
-        nodeCount: number;
-        edgeCount: number;
-        clusterCount: number;
-    };
-}
-export interface GraphResponse {
-    data: GraphData;
-    generatedAt: string;
-    cacheKey: string;
-}
-//# sourceMappingURL=graph.d.ts.map

package/packages/core/dist/types/graph.js

@@ -1,3 +0,0 @@
-// Design Ref: §3.1 — Graph Data Types
-export {};
-//# sourceMappingURL=graph.js.map

package/packages/core/dist/types/index.d.ts

@@ -1,5 +0,0 @@
-export type { Document } from './document.js';
-export type { Chunk, ScoredChunk } from './chunk.js';
-export type { SearchResult, SearchOptions, TopicInfo, StoreStats, } from './search.js';
-export type { GraphNode, GraphEdge, Cluster, GraphData, GraphResponse, } from './graph.js';
-//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/types/index.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.js.map

package/packages/core/dist/types/search.d.ts

@@ -1,39 +0,0 @@
-import type { Chunk } from './chunk.js';
-import type { Document } from './document.js';
-export interface SearchResult {
-    chunk: Chunk;
-    document: Document;
-    /** RRF 통합 점수 (0~1) */
-    score: number;
-    /** 매칭 부분 하이라이트 */
-    highlights: string[];
-}
-export interface SearchOptions {
-    query: string;
-    /** default: 10 */
-    limit?: number;
-    /** minimum score, default: 0.1 */
-    threshold?: number;
-    /** 태그 필터 */
-    tags?: string[];
-    /** 날짜 범위 필터 */
-    dateRange?: {
-        from?: string;
-        to?: string;
-    };
-}
-export interface TopicInfo {
-    topic: string;
-    count: number;
-    recentDocuments: Array<{
-        id: string;
-        title: string;
-    }>;
-}
-export interface StoreStats {
-    documentCount: number;
-    chunkCount: number;
-    dbSizeBytes: number;
-    lastIndexed: string | null;
-}
-//# sourceMappingURL=search.d.ts.map

package/packages/core/dist/types/search.js

@@ -1,3 +0,0 @@
-// Design Ref: §3.1 — Core Types (Search)
-export {};
-//# sourceMappingURL=search.js.map

package/packages/core/dist/utils/retry.d.ts

@@ -1,25 +0,0 @@
-export interface RetryOptions {
-    maxRetries?: number;
-    baseDelayMs?: number;
-    maxDelayMs?: number;
-    onRetry?: (error: Error, attempt: number, maxRetries: number) => void;
-}
-export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
-export declare class StellavaultError extends Error {
-    readonly code: string;
-    readonly suggestion?: string | undefined;
-    readonly cause?: Error | undefined;
-    constructor(message: string, code: string, suggestion?: string | undefined, cause?: Error | undefined);
-    format(): string;
-}
-export declare function wrapError(err: unknown, code: string, suggestion?: string): StellavaultError;
-export declare const errors: {
-    vaultNotFound: (path: string) => StellavaultError;
-    dbInitFailed: (err: unknown) => StellavaultError;
-    embedderFailed: (err: unknown) => StellavaultError;
-    indexingFailed: (file: string, err: unknown) => StellavaultError;
-    searchFailed: (err: unknown) => StellavaultError;
-    configInvalid: (field: string) => StellavaultError;
-    apiServerFailed: (port: number, err: unknown) => StellavaultError;
-};
-//# sourceMappingURL=retry.d.ts.map

package/packages/core/dist/utils/retry.js

@@ -1,59 +0,0 @@
-// Error Recovery System (F-A02) — retry with exponential backoff + meaningful messages
-const DEFAULT_OPTIONS = {
-    maxRetries: 3,
-    baseDelayMs: 500,
-    maxDelayMs: 10000,
-};
-export async function withRetry(fn, options = {}) {
-    const { maxRetries, baseDelayMs, maxDelayMs } = { ...DEFAULT_OPTIONS, ...options };
-    let lastError;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-        try {
-            return await fn();
-        }
-        catch (err) {
-            lastError = err instanceof Error ? err : new Error(String(err));
-            if (attempt >= maxRetries)
-                break;
-            const delay = Math.min(baseDelayMs * Math.pow(2, attempt), maxDelayMs);
-            options.onRetry?.(lastError, attempt + 1, maxRetries);
-            await new Promise((r) => setTimeout(r, delay));
-        }
-    }
-    throw lastError;
-}
-export class StellavaultError extends Error {
-    code;
-    suggestion;
-    cause;
-    constructor(message, code, suggestion, cause) {
-        super(message);
-        this.code = code;
-        this.suggestion = suggestion;
-        this.cause = cause;
-        this.name = 'StellavaultError';
-    }
-    format() {
-        const lines = [`Error [${this.code}]: ${this.message}`];
-        if (this.suggestion)
-            lines.push(`  Fix: ${this.suggestion}`);
-        if (this.cause)
-            lines.push(`  Cause: ${this.cause.message}`);
-        return lines.join('\n');
-    }
-}
-export function wrapError(err, code, suggestion) {
-    const cause = err instanceof Error ? err : new Error(String(err));
-    return new StellavaultError(cause.message, code, suggestion, cause);
-}
-// Common error factories
-export const errors = {
-    vaultNotFound: (path) => new StellavaultError(`Vault not found: ${path}`, 'VAULT_NOT_FOUND', 'Check the path exists and contains .md files'),
-    dbInitFailed: (err) => wrapError(err, 'DB_INIT_FAILED', 'Delete ~/.stellavault/index.db and re-index'),
-    embedderFailed: (err) => wrapError(err, 'EMBEDDER_FAILED', 'Check disk space and try again. The model downloads on first run (~80MB)'),
-    indexingFailed: (file, err) => wrapError(err, 'INDEX_FAILED', `Skipping "${file}". Re-run indexing to retry failed files`),
-    searchFailed: (err) => wrapError(err, 'SEARCH_FAILED', 'Re-index your vault: stellavault index <path>'),
-    configInvalid: (field) => new StellavaultError(`Invalid config: ${field}`, 'CONFIG_INVALID', 'Check ~/.stellavault.json format'),
-    apiServerFailed: (port, err) => wrapError(err, 'API_SERVER_FAILED', `Port ${port} may be in use. Try: stellavault graph --port ${port + 1}`),
-};
-//# sourceMappingURL=retry.js.map

package/packages/core/package.json

@@ -1,67 +0,0 @@
-{
-  "name": "@stellavault/core",
-  "version": "0.4.0",
-  "description": "Stellavault core engine — indexer, hybrid search, vector store, MCP server",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "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"
-    },
-    "./intelligence/wiki-compiler": {
-      "import": "./dist/intelligence/wiki-compiler.js",
-      "types": "./dist/intelligence/wiki-compiler.d.ts"
-    },
-    "./intelligence/knowledge-lint": {
-      "import": "./dist/intelligence/knowledge-lint.js",
-      "types": "./dist/intelligence/knowledge-lint.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/cors": "^2.8.19",
-    "@types/express": "^5.0.6",
-    "@types/node": "^25.5.0",
-    "typescript": "^5.7.0",
-    "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",
-    "chokidar": "^5.0.0",
-    "cors": "^2.8.6",
-    "express": "^5.2.1",
-    "gray-matter": "^4.0.3",
-    "hyperswarm": "^4.17.0",
-    "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"
-  }
-}