# TelosDB

ローカル完結型セマンティック検索基盤 & MCPサーバー

---

## 概要

**TelosDB** は、Tauri 2 と Rust を核とした、プライバシー重視のローカル特化型ナレッジベースです。
数学的な文書解析（Latent Semantic Analysis）を活用し、外部APIや重いGGUFモデルを一切介さずに、高速な意味検索と知識管理を実現します。

AIエージェントが自律的に記憶を蓄積・整理するための基盤として設計されており、**Model Context Protocol (MCP)** を通じて、LM Studio や Claude Desktop 等から即座に利用可能です。

---

## 主な機能

- **🧠 セマンティック検索 (Vector Search)**: LSA (Latent Semantic Analysis) による数学的文脈解析に基づいた高度な検索（ベクトル検索）。
- **🤖 MCP SSE サーバー内蔵**: AIエージェント（LM Studio / Claude等）からの自律的な知識操作（CRUD）が可能。
- **🔄 自動ヒーリング (Self-Healing)**: DB 内のテキストとベクトルの不一致を検出し、バックグラウンドで自動同期。
- **🛡️ 完全ローカル・プライバシー**: データ計算、ベクトル空間のすべてがローカル環境内で完結。GPU不要。
- **✨ プレミアムなUI/UX**: ミニマルなハイコントラスト・デザインを採用したデスクトップ体験。
- **📦 常駐管理**: システムトレイ常駐により、MCPサーバーをバックグラウンドで常に待機。

---

## システム構造

```mermaid
graph TD
    subgraph "Frontend (Webview)"
        UI["Minimalist Dark UI (Vanilla JS/CSS)"]
        SSE["SSE Client Monitor"]
    end

    subgraph "Backend (Rust / Tauri 2)"
        Core["Tauri Core & Command Handlers"]
        Axum["Axum (MCP SSE Server)"]
        LSA["LSA Engine (ndarray/SVD)"]
        DB[("SQLite + sqlite-vec")]
        Logger["Rotating File Logger"]
    end

    UI <-- JSON/SSE --> Axum
    Axum <-- CRUD/Search --> DB
    Core -- Analysis --> LSA
    LSA -- Vector Store --> DB
    Axum -- SQL Access --> DB
```

---

## クイックスタート

### 1. 動作要件

- Windows 10/11 (x64)
- Rust 1.77.2+
- Node.js (Bun 推奨)

### 2. モデルの準備

本バージョンは LSA (Latent Semantic Analysis) を使用するため、外部モデルファイルの配置は**不要**です。初回起動時に自動的にベクトル空間の構成が始まります。

### 3. ビルドと実行

```bash
bun install
# 開発モードでの起動
bun run tauri dev
```

---

## ディレクトリ構成

- `src/frontend/`: フロントエンド（Vanilla JS / CSS）
- `src/backend/`: バックエンド（Rust / Tauri設定 / MCP実装 / LSAエンジン）
- `docs/specification/`: システム設計書・技術仕様書
- `docs/workflow/`: プロジェクト運用・管理ルール（Issue管理等）
- `docs/issues/`: 外部 Issue トラッカー同期用（`.gitignore` 対象）
- `journals/`: 作業記録（日付別管理）

---

## ライセンス

MIT License
