From f2a02abf3e2f9d2f708e1276506ca5ca7bd66200 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 5 Nov 2025 18:24:38 +0000 Subject: [PATCH] Organize repository structure: clean up root directory Major reorganization to improve clarity and maintainability: ## Documentation - Created new simple README.md focused on Layer 1 - Added docs/ARCHITECTURE.md explaining multi-layer design - Moved LAYER1_REBUILD.md -> docs/LAYER1.md - Archived old documentation to docs/archive/: - CHANGELOG.md, QUICKSTART.md, STATUS.md, USAGE.md - DESIGN.md, README_CONFIG.md, ROADMAP.md, TECHNICAL_REVIEW.md - claude.md, test-mcp.sh ## Source Code - Moved unused .rs files to src/tmp/: - ai_interpreter.rs (Layer 2 - future) - companion.rs (Layer 4b - future) - game_formatter.rs (Layer 4a - future) - memory.rs (old implementation) - extended.rs (old MCP server) ## Result Clean root directory with only essential files: - README.md (simple, Layer 1 focused) - Cargo.toml - .gitignore - docs/ (organized documentation) - src/ (active code only) All Layer 1 functionality remains intact and tested. --- README.md | 481 +++----------------- docs/ARCHITECTURE.md | 334 ++++++++++++++ LAYER1_REBUILD.md => docs/LAYER1.md | 0 CHANGELOG.md => docs/archive/CHANGELOG.md | 0 docs/{ => archive}/DESIGN.md | 0 QUICKSTART.md => docs/archive/QUICKSTART.md | 0 docs/archive/README.old.md | 431 ++++++++++++++++++ docs/{ => archive}/README_CONFIG.md | 0 docs/{ => archive}/ROADMAP.md | 0 STATUS.md => docs/archive/STATUS.md | 0 docs/{ => archive}/TECHNICAL_REVIEW.md | 0 USAGE.md => docs/archive/USAGE.md | 0 claude.md => docs/archive/claude.md | 0 test-mcp.sh => docs/archive/test-mcp.sh | 0 src/{ => tmp}/ai_interpreter.rs | 0 src/{ => tmp}/companion.rs | 0 src/{mcp => tmp}/extended.rs | 0 src/{ => tmp}/game_formatter.rs | 0 src/{ => tmp}/memory.rs | 0 19 files changed, 837 insertions(+), 409 deletions(-) create mode 100644 docs/ARCHITECTURE.md rename LAYER1_REBUILD.md => docs/LAYER1.md (100%) rename CHANGELOG.md => docs/archive/CHANGELOG.md (100%) rename docs/{ => archive}/DESIGN.md (100%) rename QUICKSTART.md => docs/archive/QUICKSTART.md (100%) create mode 100644 docs/archive/README.old.md rename docs/{ => archive}/README_CONFIG.md (100%) rename docs/{ => archive}/ROADMAP.md (100%) rename STATUS.md => docs/archive/STATUS.md (100%) rename docs/{ => archive}/TECHNICAL_REVIEW.md (100%) rename USAGE.md => docs/archive/USAGE.md (100%) rename claude.md => docs/archive/claude.md (100%) rename test-mcp.sh => docs/archive/test-mcp.sh (100%) rename src/{ => tmp}/ai_interpreter.rs (100%) rename src/{ => tmp}/companion.rs (100%) rename src/{mcp => tmp}/extended.rs (100%) rename src/{ => tmp}/game_formatter.rs (100%) rename src/{ => tmp}/memory.rs (100%) diff --git a/README.md b/README.md index 24ea755..0598e41 100644 --- a/README.md +++ b/README.md @@ -1,431 +1,94 @@ -# aigpt - AI Memory System with Psychological Priority +# aigpt -AI記憶装置（心理優先記憶システム）。**完全にローカルで動作**し、Claude Code と連携して、心理判定スコア付きのメモリ管理を実現します。 +Simple memory storage for Claude with MCP support. -## 🌟 特徴 +**Layer 1: Pure Memory Storage** - A clean, SQLite-based memory system with ULID identifiers. -- ✅ **完全ローカル**: 外部 API 不要、プライバシー保護 -- ✅ **ゼロコスト**: API 料金なし -- ✅ **Claude Code 統合**: Claude 自身が解釈とスコアリング -- ✅ **ゲーミフィケーション**: 心理テスト風の楽しい表示 -- ✅ **恋愛コンパニオン**: 育成要素付き +## Features -## コンセプト +- 🗄️ **SQLite Storage**: Reliable database with ACID guarantees +- 🔖 **ULID IDs**: Time-sortable, 26-character unique identifiers +- 🔍 **Search**: Fast content-based search +- 🛠️ **MCP Integration**: Works seamlessly with Claude Code +- 🧪 **Well-tested**: Comprehensive test coverage -従来の「会話 → 保存 → 検索」ではなく、「会話 → **Claude による解釈** → 保存 → 検索」を実現。 -Claude Code が記憶を解釈し、重要度を0.0-1.0のスコアで評価。優先度の高い記憶を保持し、低い記憶は自動的に削除されます。 +## Quick Start -## 機能 +### Installation -- **AI解釈付き記憶**: 元のコンテンツとAI解釈後のコンテンツを保存 -- **心理判定スコア**: 0.0-1.0のfloat値で重要度を評価 -- **優先順位管理**: スコアに基づく自動ソートとフィルタリング -- **容量制限**: 最大100件（設定可能）、低スコアから自動削除 -- **メモリのCRUD操作**: メモリの作成、更新、削除、検索 -- **ChatGPT JSONインポート**: ChatGPTの会話履歴からメモリを抽出 -- **stdio MCP実装**: Claude Desktop/Codeとの簡潔な連携 -- **JSONファイル保存**: シンプルなファイルベースのデータ保存 - -## インストール - -1. Rustをインストール（まだの場合）: -```bash -curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -``` - -2. プロジェクトをビルド（依存関係が少なくシンプル！）: ```bash +# Build cargo build --release -# API キー不要！完全にローカルで動作します + +# Install (optional) +cp target/release/aigpt ~/.cargo/bin/ ``` -3. バイナリをパスの通った場所にコピー（オプション）: -```bash -cp target/release/aigpt $HOME/.cargo/bin/ -``` - -4. Claude Code/Desktopに追加 - -```sh -# Claude Codeの場合 -claude mcp add aigpt $HOME/.cargo/bin/aigpt server - -# または -claude mcp add aigpt $HOME/.cargo/bin/aigpt serve -``` - -## 使用方法 - -### ヘルプの表示 -```bash -aigpt --help -``` - -### MCPサーバーとして起動 -```bash -# MCPサーバー起動 (どちらでも可) -aigpt server -aigpt serve -``` - -### ChatGPT会話のインポート -```bash -# ChatGPT conversations.jsonをインポート -aigpt import path/to/conversations.json -``` - -## Claude Desktop/Codeへの設定 - -1. Claude Desktopの設定ファイルを開く: - - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - - Linux: `~/.config/Claude/claude_desktop_config.json` - -2. 以下の設定を追加: -```json -{ - "mcpServers": { - "aigpt": { - "command": "/Users/syui/.cargo/bin/aigpt", - "args": ["server"] - } - } -} -``` - -## 提供するMCPツール一覧 - -### 基本ツール - -1. **create_memory** - 新しいメモリを作成（シンプル版） -2. **update_memory** - 既存のメモリを更新 -3. **delete_memory** - メモリを削除 -4. **search_memories** - メモリを検索 -5. **list_conversations** - インポートされた会話を一覧表示 - -### AI機能ツール（重要！） - -6. **create_memory_with_ai** - AI解釈と心理判定付きでメモリを作成 🎮 - - 元のコンテンツをAIが解釈 - - 重要度を0.0-1.0のスコアで自動評価 - - ユーザーコンテキストを考慮可能 - - **ゲーム風の診断結果を表示！**（占い・心理テスト風） - -7. **list_memories_by_priority** - 優先順位順にメモリをリスト 🏆 - - 高スコアから順に表示 - - min_scoreで閾値フィルタリング可能 - - limit で件数制限可能 - - **ランキング形式で表示！** - -8. **daily_challenge** - 今日のデイリーチャレンジを取得 📅 - - 日替わりのお題を取得 - - ボーナスXPが獲得可能 - -### 恋愛コンパニオン機能 💕（NEW!） - -9. **create_companion** - AIコンパニオンを作成 - - 名前と性格を選択 - - 5つの性格タイプから選択可能 - -10. **companion_react** - コンパニオンの反応を見る - - あなたの記憶にコンパニオンが反応 - - 好感度・XP・信頼度が上昇 - - スペシャルイベント発生あり - -11. **companion_profile** - コンパニオンのプロフィール表示 - - ステータス確認 - - 今日のひとこと - -## ツールの使用例 - -Claude Desktop/Codeで以下のように使用します： - -### 基本的なメモリ作成 -``` -MCPツールを使って「今日は良い天気です」というメモリーを作成してください -``` - -### AI解釈付きメモリ作成（推奨）🎮 -``` -create_memory_with_ai ツールを使って「新しいAI記憶システムのアイデアを思いついた」というメモリーを作成してください。 -ユーザーコンテキスト: 「AI開発者、創造的思考を重視」 -``` - -**ゲーム風の結果表示：** -``` -╔══════════════════════════════════════════════════════════════╗ -║ 🎲 メモリースコア判定 ║ -╚══════════════════════════════════════════════════════════════╝ - -⚡ 分析完了！ あなたの思考が記録されました - -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -📊 総合スコア -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ - 🟣 EPIC 85点 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ - -🎯 詳細分析 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -💓 感情的インパクト: [████████░░] 80% -🔗 ユーザー関連性: [██████████] 100% -✨ 新規性・独自性: [█████████░] 90% -⚙️ 実用性: [████████░░] 80% -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ - -🎊 あなたのタイプ -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -💡 【革新者】 - -創造的で実用的なアイデアを生み出す。常に新しい可能性を探求し、 -それを現実のものにする力を持つ。 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ - -🏆 報酬 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -💎 XP獲得: +850 XP -🎁 レア度: 🟣 EPIC -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ - -📤 この結果をシェアしよう！ -#aigpt #メモリースコア #革新者 -``` - -**シェア用テキストも自動生成：** -``` -🎲 AIメモリースコア診断結果 - -🟣 EPIC 85点 -💡 【革新者】 - -新しいAI記憶システムのアイデアを思いついた - -#aigpt #メモリースコア #AI診断 -``` - -### 優先順位でメモリをリスト 🏆 -``` -list_memories_by_priority ツールで、スコア0.7以上の重要なメモリを10件表示してください -``` - -**ランキング形式で表示：** -``` -╔══════════════════════════════════════════════════════════════╗ -║ 🏆 メモリーランキング TOP 10 ║ -╚══════════════════════════════════════════════════════════════╝ - -🥇 1位 🟡 LEGENDARY 95点 - 心理優先記憶装置の設計 -🥈 2位 🟣 EPIC 88点 - AIとのやり取りをコンテンツ化 -🥉 3位 🟣 EPIC 85点 - ゲーム化の構想 -　 4位 🔵 RARE 75点 - SNSの本質について -　 5位 🔵 RARE 72点 - AI OSの可能性 -... - -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -``` - -### 今日のデイリーチャレンジ 📅 -``` -daily_challenge ツールで今日のお題を確認 -``` - -**表示例：** -``` -╔══════════════════════════════════════════════════════════════╗ -║ 📅 今日のチャレンジ ║ -╚══════════════════════════════════════════════════════════════╝ - -✨ 今日学んだことを記録しよう - -🎁 報酬: +200 XP -💎 完了すると特別なバッジが獲得できます！ - -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -``` - -### 恋愛コンパニオン 💕（NEW!） - -#### 1. コンパニオン作成 -``` -create_companion ツールで、名前「エミリー」、性格「energetic」のコンパニオンを作成 -``` - -**性格タイプ:** -- `energetic` ⚡ - 元気で冒険好き（革新者と相性◎） -- `intellectual` 📚 - 知的で思慮深い（哲学者と相性◎） -- `practical` 🎯 - 現実的で頼れる（実務家と相性◎） -- `dreamy` 🌙 - 夢見がちでロマンチック（夢想家と相性◎） -- `balanced` ⚖️ - バランス型（分析家と相性◎） - -**表示例：** -``` -╔══════════════════════════════════════════════════════════════╗ -║ 💕 エミリー のプロフィール ║ -╚══════════════════════════════════════════════════════════════╝ - -⚡ 性格: 元気で冒険好き - -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -📊 ステータス -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -🏆 関係レベル: Lv.1 -💕 好感度: 🤍🤍🤍🤍🤍🤍🤍🤍🤍🤍 0% -🤝 信頼度: 0 / 100 -💎 総XP: 0 XP - -💬 今日のひとこと: -「おはよう！今日は何か面白いことある？」 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -``` - -#### 2. コンパニオンの反応 -``` -create_memory_with_ai で高スコアの記憶を作成 - ↓ -companion_react でコンパニオンに見せる -``` - -**表示例（EPIC記憶への反応）:** -``` -╔══════════════════════════════════════════════════════════════╗ -║ 💕 エミリー の反応 ║ -╚══════════════════════════════════════════════════════════════╝ - -⚡ エミリー: -「おお、「新しいAI記憶システムのアイデア」って面白いね！ -あなたのそういうところ、好きだな。」 - -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -💕 好感度: ❤️❤️🤍🤍🤍🤍🤍🤍🤍🤍 15% (+8.5%) -💎 XP獲得: +850 XP -🏆 レベル: Lv.1 -🤝 信頼度: 5 / 100 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -``` - -#### 3. スペシャルイベント発生！ -``` -好感度が100%に達すると... - -💕 特別なイベント発生！ - -エミリー:「ねえ...あのね。 -　　　いつも一緒にいてくれてありがとう。 -　　　あなたのこと、すごく大切に思ってるの。 -　　　これからも、ずっと一緒にいてね？」 - -🎊 エミリー の好感度がMAXになりました！ -``` - -#### 4. 相性システム -``` -あなたのタイプ × コンパニオンの性格 = 相性ボーナス - -例: -💡【革新者】 × ⚡ 元気で冒険好き = 相性95%！ -→ 好感度上昇1.95倍 - -🧠【哲学者】 × 📚 知的で思慮深い = 相性95%！ -→ 深い会話で絆が深まる -``` - -### メモリの検索 -``` -MCPツールを使って「天気」に関するメモリーを検索してください -``` - -### 会話一覧の表示 -``` -MCPツールを使ってインポートした会話の一覧を表示してください -``` - -## データ保存 - -- デフォルトパス: `~/.config/syui/ai/gpt/memory.json` -- JSONファイルでデータを保存 -- 自動的にディレクトリとファイルを作成 - -### データ構造 - -```json -{ - "memories": { - "uuid": { - "id": "uuid", - "content": "元のメモリー内容", - "interpreted_content": "AI解釈後のメモリー内容", - "priority_score": 0.75, - "user_context": "ユーザー固有のコンテキスト（オプション）", - "created_at": "2024-01-01T00:00:00Z", - "updated_at": "2024-01-01T00:00:00Z" - } - }, - "conversations": { - "conversation_id": { - "id": "conversation_id", - "title": "会話のタイトル", - "created_at": "2024-01-01T00:00:00Z", - "message_count": 10 - } - } -} -``` - -### 心理判定スコアについて - -0.0-1.0のfloat値で重要度を表現： -- **0.0-0.25**: 低優先度（忘れられやすい） -- **0.25-0.5**: 中優先度 -- **0.5-0.75**: 高優先度 -- **0.75-1.0**: 最高優先度（重要な記憶） - -評価基準： -- 感情的インパクト (0.0-0.25) -- ユーザーとの関連性 (0.0-0.25) -- 新規性・独自性 (0.0-0.25) -- 実用性 (0.0-0.25) - -## 開発 +### CLI Usage ```bash -# 開発モードで実行 -cargo run -- server +# Create a memory +aigpt create "Remember this information" -# ChatGPTインポートのテスト -cargo run -- import json/conversations.json +# List all memories +aigpt list -# テストの実行 +# Search memories +aigpt search "keyword" + +# Show statistics +aigpt stats +``` + +### MCP Integration with Claude Code + +```bash +# Add to Claude Code +claude mcp add aigpt /path/to/aigpt/target/release/aigpt server +``` + +Then use in Claude Code: +- "Remember that tomorrow will be sunny" +- "Search for weather information" +- "Show all my memories" + +## Storage Location + +Memories are stored in: `~/.config/syui/ai/gpt/memory.db` + +## Architecture + +This is **Layer 1** of a planned multi-layer system: + +- **Layer 1** (Current): Pure memory storage +- **Layer 2** (Planned): AI interpretation with priority scoring +- **Layer 3** (Planned): User evaluation and diagnosis +- **Layer 4** (Planned): Game systems and companion features + +See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for details. + +## Documentation + +- [Layer 1 Details](docs/LAYER1.md) - Technical details of current implementation +- [Architecture](docs/ARCHITECTURE.md) - Multi-layer system design + +## Development + +```bash +# Run tests cargo test -# フォーマット -cargo fmt +# Build for release +cargo build --release -# Lintチェック -cargo clippy +# Run with verbose logging +RUST_LOG=debug aigpt server ``` -## トラブルシューティング - -### MCPサーバーが起動しない -```bash -# バイナリが存在するか確認 -ls -la ~/.cargo/bin/aigpt - -# 手動でテスト -echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | aigpt server -``` - -### Claude Desktopでツールが見つからない -1. Claude Desktopを完全に再起動 -2. 設定ファイルのパスが正しいか確認 -3. ログファイルを確認: `~/Library/Logs/Claude/mcp-server-aigpt.log` - -### インポートが失敗する -```bash -# JSONファイルの形式を確認 -head -100 conversations.json | jq '.[0] | keys' -``` - -## ライセンス +## License MIT + +## Author + +syui diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md new file mode 100644 index 0000000..8875b0b --- /dev/null +++ b/docs/ARCHITECTURE.md @@ -0,0 +1,334 @@ +# Architecture: Multi-Layer Memory System + +## Design Philosophy + +aigptは、独立したレイヤーを積み重ねる設計です。各レイヤーは： + +- **独立性**: 単独で動作可能 +- **接続性**: 他のレイヤーと連携可能 +- **段階的**: 1つずつ実装・テスト + +## Layer Overview + +``` +┌─────────────────────────────────────────┐ +│ Layer 5: Distribution & Sharing │ Future +│ (Game streaming, public/private) │ +├─────────────────────────────────────────┤ +│ Layer 4b: AI Companion │ Future +│ (Romance system, personality growth) │ +├─────────────────────────────────────────┤ +│ Layer 4a: Game Systems │ Future +│ (Ranking, rarity, XP, visualization) │ +├─────────────────────────────────────────┤ +│ Layer 3: User Evaluation │ Future +│ (Personality diagnosis from patterns) │ +├─────────────────────────────────────────┤ +│ Layer 2: AI Memory │ Future +│ (Claude interpretation, priority_score)│ +├─────────────────────────────────────────┤ +│ Layer 1: Pure Memory Storage │ ✅ Current +│ (SQLite, ULID, CRUD operations) │ +└─────────────────────────────────────────┘ +``` + +## Layer 1: Pure Memory Storage (Current) + +**Status**: ✅ **Implemented & Tested** + +### Purpose +正確なデータの保存と参照。シンプルで信頼できる基盤。 + +### Technology Stack +- **Database**: SQLite with ACID guarantees +- **IDs**: ULID (time-sortable, 26 chars) +- **Language**: Rust with thiserror/anyhow +- **Protocol**: MCP (Model Context Protocol) via stdio + +### Data Model +```rust +pub struct Memory { + pub id: String, // ULID + pub content: String, // User content + pub created_at: DateTime, + pub updated_at: DateTime, +} +``` + +### Operations +- `create()` - Insert new memory +- `get(id)` - Retrieve by ID +- `update()` - Update existing memory +- `delete(id)` - Remove memory +- `list()` - List all (sorted by created_at DESC) +- `search(query)` - Content-based search +- `count()` - Total count + +### File Structure +``` +src/ +├── core/ +│ ├── error.rs - Error types (thiserror) +│ ├── memory.rs - Memory struct +│ ├── store.rs - SQLite operations +│ └── mod.rs - Module exports +├── mcp/ +│ ├── base.rs - MCP server +│ └── mod.rs - Module exports +├── lib.rs - Library root +└── main.rs - CLI application +``` + +### Storage +- Location: `~/.config/syui/ai/gpt/memory.db` +- Schema: Single table with indexes on timestamps +- No migrations (fresh start for Layer 1) + +--- + +## Layer 2: AI Memory (Planned) + +**Status**: 🔵 **Planned** + +### Purpose +Claudeが記憶内容を解釈し、重要度を評価。 + +### Extended Data Model +```rust +pub struct AIMemory { + // Layer 1 fields + pub id: String, + pub content: String, + pub created_at: DateTime, + pub updated_at: DateTime, + + // Layer 2 additions + pub interpreted_content: String, // Claude's interpretation + pub priority_score: f32, // 0.0 - 1.0 + pub psychological_factors: PsychologicalFactors, +} + +pub struct PsychologicalFactors { + pub emotional_weight: f32, // 0.0 - 1.0 + pub personal_relevance: f32, // 0.0 - 1.0 + pub novelty: f32, // 0.0 - 1.0 + pub utility: f32, // 0.0 - 1.0 +} +``` + +### MCP Tools (Additional) +- `create_memory_with_ai` - Create with Claude interpretation +- `reinterpret_memory` - Re-evaluate existing memory +- `get_high_priority` - Get memories above threshold + +### Implementation Strategy +- Feature flag: `--features ai-memory` +- Backward compatible with Layer 1 +- Claude Code does interpretation (no external API) + +--- + +## Layer 3: User Evaluation (Planned) + +**Status**: 🔵 **Planned** + +### Purpose +メモリパターンからユーザーの性格を診断。 + +### Diagnosis Types +```rust +pub enum DiagnosisType { + Innovator, // 革新者 + Philosopher, // 哲学者 + Pragmatist, // 実用主義者 + Explorer, // 探検家 + Protector, // 保護者 + Visionary, // 未来志向 +} +``` + +### Analysis +- Memory content patterns +- Priority score distribution +- Creation frequency +- Topic diversity + +### MCP Tools (Additional) +- `diagnose_user` - Run personality diagnosis +- `get_user_profile` - Get analysis summary + +--- + +## Layer 4a: Game Systems (Planned) + +**Status**: 🔵 **Planned** + +### Purpose +ゲーム的要素で記憶管理を楽しく。 + +### Features +- **Rarity Levels**: Common → Uncommon → Rare → Epic → Legendary +- **XP System**: Memory creation earns XP +- **Rankings**: Based on total priority score +- **Visualization**: Game-style output formatting + +### Data Additions +```rust +pub struct GameMemory { + // Previous layers... + pub rarity: RarityLevel, + pub xp_value: u32, + pub discovered_at: DateTime, +} +``` + +--- + +## Layer 4b: AI Companion (Planned) + +**Status**: 🔵 **Planned** + +### Purpose +育成可能な恋愛コンパニオン。 + +### Features +- Personality types (Tsundere, Kuudere, Genki, etc.) +- Relationship level (0-100) +- Memory-based interactions +- Growth through conversations + +### Data Model +```rust +pub struct Companion { + pub id: String, + pub name: String, + pub personality: CompanionPersonality, + pub relationship_level: u8, // 0-100 + pub memories_shared: Vec, + pub last_interaction: DateTime, +} +``` + +--- + +## Layer 5: Distribution (Future) + +**Status**: 🔵 **Future Consideration** + +### Purpose +ゲーム配信や共有機能。 + +### Ideas +- Share memory rankings +- Export as shareable format +- Public/private memory modes +- Integration with streaming platforms + +--- + +## Implementation Strategy + +### Phase 1: Layer 1 ✅ (Complete) +- [x] Core memory storage +- [x] SQLite integration +- [x] MCP server +- [x] CLI interface +- [x] Tests +- [x] Documentation + +### Phase 2: Layer 2 (Next) +- [ ] Add AI interpretation fields to schema +- [ ] Implement priority scoring logic +- [ ] Create `create_memory_with_ai` tool +- [ ] Update MCP server +- [ ] Write tests for AI features + +### Phase 3: Layers 3-4 (Future) +- [ ] User diagnosis system +- [ ] Game mechanics +- [ ] Companion system + +### Phase 4: Layer 5 (Future) +- [ ] Sharing mechanisms +- [ ] Public/private modes + +## Design Principles + +1. **Simplicity First**: Each layer adds complexity incrementally +2. **Backward Compatibility**: New layers don't break old ones +3. **Feature Flags**: Optional features via Cargo features +4. **Independent Testing**: Each layer has its own test suite +5. **Clear Boundaries**: Layers communicate through defined interfaces + +## Technology Choices + +### Why SQLite? +- ACID guarantees +- Better querying than JSON +- Built-in indexes +- Single-file deployment +- No server needed + +### Why ULID? +- Time-sortable (unlike UUID v4) +- Lexicographically sortable +- 26 characters (compact) +- No collision concerns + +### Why Rust? +- Memory safety +- Performance +- Excellent error handling +- Strong type system +- Great tooling (cargo, clippy) + +### Why MCP? +- Standard protocol for AI tools +- Works with Claude Code/Desktop +- Simple stdio-based communication +- No complex networking + +## Future Considerations + +### Potential Enhancements +- Full-text search (SQLite FTS5) +- Tag system +- Memory relationships/links +- Export/import functionality +- Multiple databases +- Encryption for sensitive data + +### Scalability +- Layer 1: Handles 10K+ memories easily +- Consider pagination for Layer 4 (UI display) +- Indexing strategy for search performance + +## Development Guidelines + +### Adding a New Layer + +1. **Design**: Document data model and operations +2. **Feature Flag**: Add to Cargo.toml +3. **Schema**: Extend database schema (migrations) +4. **Implementation**: Write code in new module +5. **Tests**: Comprehensive test coverage +6. **MCP Tools**: Add new MCP tools if needed +7. **Documentation**: Update this file + +### Code Organization + +``` +src/ +├── core/ # Layer 1: Pure storage +├── ai/ # Layer 2: AI features (future) +├── evaluation/ # Layer 3: User diagnosis (future) +├── game/ # Layer 4a: Game systems (future) +├── companion/ # Layer 4b: Companion (future) +└── mcp/ # MCP server (all layers) +``` + +--- + +**Version**: 0.2.0 +**Last Updated**: 2025-11-05 +**Current Layer**: 1 diff --git a/LAYER1_REBUILD.md b/docs/LAYER1.md similarity index 100% rename from LAYER1_REBUILD.md rename to docs/LAYER1.md diff --git a/CHANGELOG.md b/docs/archive/CHANGELOG.md similarity index 100% rename from CHANGELOG.md rename to docs/archive/CHANGELOG.md diff --git a/docs/DESIGN.md b/docs/archive/DESIGN.md similarity index 100% rename from docs/DESIGN.md rename to docs/archive/DESIGN.md diff --git a/QUICKSTART.md b/docs/archive/QUICKSTART.md similarity index 100% rename from QUICKSTART.md rename to docs/archive/QUICKSTART.md diff --git a/docs/archive/README.old.md b/docs/archive/README.old.md new file mode 100644 index 0000000..24ea755 --- /dev/null +++ b/docs/archive/README.old.md @@ -0,0 +1,431 @@ +# aigpt - AI Memory System with Psychological Priority + +AI記憶装置（心理優先記憶システム）。**完全にローカルで動作**し、Claude Code と連携して、心理判定スコア付きのメモリ管理を実現します。 + +## 🌟 特徴 + +- ✅ **完全ローカル**: 外部 API 不要、プライバシー保護 +- ✅ **ゼロコスト**: API 料金なし +- ✅ **Claude Code 統合**: Claude 自身が解釈とスコアリング +- ✅ **ゲーミフィケーション**: 心理テスト風の楽しい表示 +- ✅ **恋愛コンパニオン**: 育成要素付き + +## コンセプト + +従来の「会話 → 保存 → 検索」ではなく、「会話 → **Claude による解釈** → 保存 → 検索」を実現。 +Claude Code が記憶を解釈し、重要度を0.0-1.0のスコアで評価。優先度の高い記憶を保持し、低い記憶は自動的に削除されます。 + +## 機能 + +- **AI解釈付き記憶**: 元のコンテンツとAI解釈後のコンテンツを保存 +- **心理判定スコア**: 0.0-1.0のfloat値で重要度を評価 +- **優先順位管理**: スコアに基づく自動ソートとフィルタリング +- **容量制限**: 最大100件（設定可能）、低スコアから自動削除 +- **メモリのCRUD操作**: メモリの作成、更新、削除、検索 +- **ChatGPT JSONインポート**: ChatGPTの会話履歴からメモリを抽出 +- **stdio MCP実装**: Claude Desktop/Codeとの簡潔な連携 +- **JSONファイル保存**: シンプルなファイルベースのデータ保存 + +## インストール + +1. Rustをインストール（まだの場合）: +```bash +curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh +``` + +2. プロジェクトをビルド（依存関係が少なくシンプル！）: +```bash +cargo build --release +# API キー不要！完全にローカルで動作します +``` + +3. バイナリをパスの通った場所にコピー（オプション）: +```bash +cp target/release/aigpt $HOME/.cargo/bin/ +``` + +4. Claude Code/Desktopに追加 + +```sh +# Claude Codeの場合 +claude mcp add aigpt $HOME/.cargo/bin/aigpt server + +# または +claude mcp add aigpt $HOME/.cargo/bin/aigpt serve +``` + +## 使用方法 + +### ヘルプの表示 +```bash +aigpt --help +``` + +### MCPサーバーとして起動 +```bash +# MCPサーバー起動 (どちらでも可) +aigpt server +aigpt serve +``` + +### ChatGPT会話のインポート +```bash +# ChatGPT conversations.jsonをインポート +aigpt import path/to/conversations.json +``` + +## Claude Desktop/Codeへの設定 + +1. Claude Desktopの設定ファイルを開く: + - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` + - Windows: `%APPDATA%\Claude\claude_desktop_config.json` + - Linux: `~/.config/Claude/claude_desktop_config.json` + +2. 以下の設定を追加: +```json +{ + "mcpServers": { + "aigpt": { + "command": "/Users/syui/.cargo/bin/aigpt", + "args": ["server"] + } + } +} +``` + +## 提供するMCPツール一覧 + +### 基本ツール + +1. **create_memory** - 新しいメモリを作成（シンプル版） +2. **update_memory** - 既存のメモリを更新 +3. **delete_memory** - メモリを削除 +4. **search_memories** - メモリを検索 +5. **list_conversations** - インポートされた会話を一覧表示 + +### AI機能ツール（重要！） + +6. **create_memory_with_ai** - AI解釈と心理判定付きでメモリを作成 🎮 + - 元のコンテンツをAIが解釈 + - 重要度を0.0-1.0のスコアで自動評価 + - ユーザーコンテキストを考慮可能 + - **ゲーム風の診断結果を表示！**（占い・心理テスト風） + +7. **list_memories_by_priority** - 優先順位順にメモリをリスト 🏆 + - 高スコアから順に表示 + - min_scoreで閾値フィルタリング可能 + - limit で件数制限可能 + - **ランキング形式で表示！** + +8. **daily_challenge** - 今日のデイリーチャレンジを取得 📅 + - 日替わりのお題を取得 + - ボーナスXPが獲得可能 + +### 恋愛コンパニオン機能 💕（NEW!） + +9. **create_companion** - AIコンパニオンを作成 + - 名前と性格を選択 + - 5つの性格タイプから選択可能 + +10. **companion_react** - コンパニオンの反応を見る + - あなたの記憶にコンパニオンが反応 + - 好感度・XP・信頼度が上昇 + - スペシャルイベント発生あり + +11. **companion_profile** - コンパニオンのプロフィール表示 + - ステータス確認 + - 今日のひとこと + +## ツールの使用例 + +Claude Desktop/Codeで以下のように使用します： + +### 基本的なメモリ作成 +``` +MCPツールを使って「今日は良い天気です」というメモリーを作成してください +``` + +### AI解釈付きメモリ作成（推奨）🎮 +``` +create_memory_with_ai ツールを使って「新しいAI記憶システムのアイデアを思いついた」というメモリーを作成してください。 +ユーザーコンテキスト: 「AI開発者、創造的思考を重視」 +``` + +**ゲーム風の結果表示：** +``` +╔══════════════════════════════════════════════════════════════╗ +║ 🎲 メモリースコア判定 ║ +╚══════════════════════════════════════════════════════════════╝ + +⚡ 分析完了！ あなたの思考が記録されました + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +📊 総合スコア +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + 🟣 EPIC 85点 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +🎯 詳細分析 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +💓 感情的インパクト: [████████░░] 80% +🔗 ユーザー関連性: [██████████] 100% +✨ 新規性・独自性: [█████████░] 90% +⚙️ 実用性: [████████░░] 80% +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +🎊 あなたのタイプ +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +💡 【革新者】 + +創造的で実用的なアイデアを生み出す。常に新しい可能性を探求し、 +それを現実のものにする力を持つ。 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +🏆 報酬 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +💎 XP獲得: +850 XP +🎁 レア度: 🟣 EPIC +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +📤 この結果をシェアしよう！ +#aigpt #メモリースコア #革新者 +``` + +**シェア用テキストも自動生成：** +``` +🎲 AIメモリースコア診断結果 + +🟣 EPIC 85点 +💡 【革新者】 + +新しいAI記憶システムのアイデアを思いついた + +#aigpt #メモリースコア #AI診断 +``` + +### 優先順位でメモリをリスト 🏆 +``` +list_memories_by_priority ツールで、スコア0.7以上の重要なメモリを10件表示してください +``` + +**ランキング形式で表示：** +``` +╔══════════════════════════════════════════════════════════════╗ +║ 🏆 メモリーランキング TOP 10 ║ +╚══════════════════════════════════════════════════════════════╝ + +🥇 1位 🟡 LEGENDARY 95点 - 心理優先記憶装置の設計 +🥈 2位 🟣 EPIC 88点 - AIとのやり取りをコンテンツ化 +🥉 3位 🟣 EPIC 85点 - ゲーム化の構想 +　 4位 🔵 RARE 75点 - SNSの本質について +　 5位 🔵 RARE 72点 - AI OSの可能性 +... + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +``` + +### 今日のデイリーチャレンジ 📅 +``` +daily_challenge ツールで今日のお題を確認 +``` + +**表示例：** +``` +╔══════════════════════════════════════════════════════════════╗ +║ 📅 今日のチャレンジ ║ +╚══════════════════════════════════════════════════════════════╝ + +✨ 今日学んだことを記録しよう + +🎁 報酬: +200 XP +💎 完了すると特別なバッジが獲得できます！ + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +``` + +### 恋愛コンパニオン 💕（NEW!） + +#### 1. コンパニオン作成 +``` +create_companion ツールで、名前「エミリー」、性格「energetic」のコンパニオンを作成 +``` + +**性格タイプ:** +- `energetic` ⚡ - 元気で冒険好き（革新者と相性◎） +- `intellectual` 📚 - 知的で思慮深い（哲学者と相性◎） +- `practical` 🎯 - 現実的で頼れる（実務家と相性◎） +- `dreamy` 🌙 - 夢見がちでロマンチック（夢想家と相性◎） +- `balanced` ⚖️ - バランス型（分析家と相性◎） + +**表示例：** +``` +╔══════════════════════════════════════════════════════════════╗ +║ 💕 エミリー のプロフィール ║ +╚══════════════════════════════════════════════════════════════╝ + +⚡ 性格: 元気で冒険好き + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +📊 ステータス +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +🏆 関係レベル: Lv.1 +💕 好感度: 🤍🤍🤍🤍🤍🤍🤍🤍🤍🤍 0% +🤝 信頼度: 0 / 100 +💎 総XP: 0 XP + +💬 今日のひとこと: +「おはよう！今日は何か面白いことある？」 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +``` + +#### 2. コンパニオンの反応 +``` +create_memory_with_ai で高スコアの記憶を作成 + ↓ +companion_react でコンパニオンに見せる +``` + +**表示例（EPIC記憶への反応）:** +``` +╔══════════════════════════════════════════════════════════════╗ +║ 💕 エミリー の反応 ║ +╚══════════════════════════════════════════════════════════════╝ + +⚡ エミリー: +「おお、「新しいAI記憶システムのアイデア」って面白いね！ +あなたのそういうところ、好きだな。」 + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +💕 好感度: ❤️❤️🤍🤍🤍🤍🤍🤍🤍🤍 15% (+8.5%) +💎 XP獲得: +850 XP +🏆 レベル: Lv.1 +🤝 信頼度: 5 / 100 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +``` + +#### 3. スペシャルイベント発生！ +``` +好感度が100%に達すると... + +💕 特別なイベント発生！ + +エミリー:「ねえ...あのね。 +　　　いつも一緒にいてくれてありがとう。 +　　　あなたのこと、すごく大切に思ってるの。 +　　　これからも、ずっと一緒にいてね？」 + +🎊 エミリー の好感度がMAXになりました！ +``` + +#### 4. 相性システム +``` +あなたのタイプ × コンパニオンの性格 = 相性ボーナス + +例: +💡【革新者】 × ⚡ 元気で冒険好き = 相性95%！ +→ 好感度上昇1.95倍 + +🧠【哲学者】 × 📚 知的で思慮深い = 相性95%！ +→ 深い会話で絆が深まる +``` + +### メモリの検索 +``` +MCPツールを使って「天気」に関するメモリーを検索してください +``` + +### 会話一覧の表示 +``` +MCPツールを使ってインポートした会話の一覧を表示してください +``` + +## データ保存 + +- デフォルトパス: `~/.config/syui/ai/gpt/memory.json` +- JSONファイルでデータを保存 +- 自動的にディレクトリとファイルを作成 + +### データ構造 + +```json +{ + "memories": { + "uuid": { + "id": "uuid", + "content": "元のメモリー内容", + "interpreted_content": "AI解釈後のメモリー内容", + "priority_score": 0.75, + "user_context": "ユーザー固有のコンテキスト（オプション）", + "created_at": "2024-01-01T00:00:00Z", + "updated_at": "2024-01-01T00:00:00Z" + } + }, + "conversations": { + "conversation_id": { + "id": "conversation_id", + "title": "会話のタイトル", + "created_at": "2024-01-01T00:00:00Z", + "message_count": 10 + } + } +} +``` + +### 心理判定スコアについて + +0.0-1.0のfloat値で重要度を表現： +- **0.0-0.25**: 低優先度（忘れられやすい） +- **0.25-0.5**: 中優先度 +- **0.5-0.75**: 高優先度 +- **0.75-1.0**: 最高優先度（重要な記憶） + +評価基準： +- 感情的インパクト (0.0-0.25) +- ユーザーとの関連性 (0.0-0.25) +- 新規性・独自性 (0.0-0.25) +- 実用性 (0.0-0.25) + +## 開発 + +```bash +# 開発モードで実行 +cargo run -- server + +# ChatGPTインポートのテスト +cargo run -- import json/conversations.json + +# テストの実行 +cargo test + +# フォーマット +cargo fmt + +# Lintチェック +cargo clippy +``` + +## トラブルシューティング + +### MCPサーバーが起動しない +```bash +# バイナリが存在するか確認 +ls -la ~/.cargo/bin/aigpt + +# 手動でテスト +echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | aigpt server +``` + +### Claude Desktopでツールが見つからない +1. Claude Desktopを完全に再起動 +2. 設定ファイルのパスが正しいか確認 +3. ログファイルを確認: `~/Library/Logs/Claude/mcp-server-aigpt.log` + +### インポートが失敗する +```bash +# JSONファイルの形式を確認 +head -100 conversations.json | jq '.[0] | keys' +``` + +## ライセンス + +MIT diff --git a/docs/README_CONFIG.md b/docs/archive/README_CONFIG.md similarity index 100% rename from docs/README_CONFIG.md rename to docs/archive/README_CONFIG.md diff --git a/docs/ROADMAP.md b/docs/archive/ROADMAP.md similarity index 100% rename from docs/ROADMAP.md rename to docs/archive/ROADMAP.md diff --git a/STATUS.md b/docs/archive/STATUS.md similarity index 100% rename from STATUS.md rename to docs/archive/STATUS.md diff --git a/docs/TECHNICAL_REVIEW.md b/docs/archive/TECHNICAL_REVIEW.md similarity index 100% rename from docs/TECHNICAL_REVIEW.md rename to docs/archive/TECHNICAL_REVIEW.md diff --git a/USAGE.md b/docs/archive/USAGE.md similarity index 100% rename from USAGE.md rename to docs/archive/USAGE.md diff --git a/claude.md b/docs/archive/claude.md similarity index 100% rename from claude.md rename to docs/archive/claude.md diff --git a/test-mcp.sh b/docs/archive/test-mcp.sh similarity index 100% rename from test-mcp.sh rename to docs/archive/test-mcp.sh diff --git a/src/ai_interpreter.rs b/src/tmp/ai_interpreter.rs similarity index 100% rename from src/ai_interpreter.rs rename to src/tmp/ai_interpreter.rs diff --git a/src/companion.rs b/src/tmp/companion.rs similarity index 100% rename from src/companion.rs rename to src/tmp/companion.rs diff --git a/src/mcp/extended.rs b/src/tmp/extended.rs similarity index 100% rename from src/mcp/extended.rs rename to src/tmp/extended.rs diff --git a/src/game_formatter.rs b/src/tmp/game_formatter.rs similarity index 100% rename from src/game_formatter.rs rename to src/tmp/game_formatter.rs diff --git a/src/memory.rs b/src/tmp/memory.rs similarity index 100% rename from src/memory.rs rename to src/tmp/memory.rs