directory

TCAM Memory System

TCAM v1.4（Triadic Cognitive Augmentation Model）向けのレジリエントな4層メモリアーキテクチャ

概要

TCAM Memory System は、各レイヤーが独立して動作するフォールトトレラントなメモリアーキテクチャを実装しており、あるレイヤーでシステム障害が発生しても、ほかのレイヤーに波及しません。メモリ操作は、Qwen 3.5 9B（ローカル LLM）上で動作する専用の Memory Service が処理します。

アーキテクチャ

4つの独立したレイヤー

• L1：Chronicle - 不変の履歴記録（ファイルシステム、markdown）
• L2：Active Stream - 揮発性の作業メモリ（Cloud LLM コンテキスト + Redis）
• L3：Hive Mind - セマンティックメモリ（Qdrant ベクトルデータベース + Mem0）
• L4：Agent Codex - 個人用ナレッジベース（ファイルシステム、markdown）

Memory Service

Qwen 3.5 9B 上で動作する専用プロセスで、以下を実行します。

• 対話からの真実の抽出
• Chronicle への記録
• Hive Mind のインデックス作成
• Agent Codex の更新
• スリーピングサイクルのオーケストレーション

技術スタック

• TypeScript/Node.js - コア実装
• Qwen 3.5 9B - メモリ操作用のローカル LLM
• Mem0 - 事実の自動抽出
• Qdrant - セマンティック検索用のベクトルデータベース
• Redis - 高速な状態の永続化（LangGraph チェックポインター）
• LangGraph - マルチエージェントのオーケストレーション
• Jest - テストフレームワーク
• fast-check - プロパティベーステスト

プロジェクト構成

.
├── src/                    # Source code
├── tests/                  # Test files
├── data/                   # Chronicle storage
├── codex/                  # Agent Codex (L4)
├── docs/                   # Documentation
└── .kiro/specs/           # Specification documents

はじめに

前提条件

• Node.js 18+
• Ollama（Qwen 3.5 9B 用）
• Docker（Qdrant と Redis 用）

インストール

# Install dependencies
npm install --legacy-peer-deps

# Pull Qwen 3.5 9B model
ollama pull qwen2.5:9b-instruct-q4_K_M

# Pull embedding model
ollama pull nomic-embed-text

# Start Qdrant (using setup script)
# Windows PowerShell:
.\scripts\setup-qdrant.ps1

# Linux/Mac:
bash scripts/setup-qdrant.sh

# Or manually with Docker:
docker run -d --name qdrant -p 6333:6333 -p 6334:6334 -v qdrant_storage:/qdrant/storage qdrant/qdrant

# Start Redis
docker run -d --name redis -p 6379:6379 redis

# Build and install globally
npm run build
npm install -g . --legacy-peer-deps

CLI の使い方

# Interactive main menu
anots

# Real-time monitoring dashboard (Terminal UI)
anots dashboard

# Chat with Axiom (TCAM Node C)
anots axiom

# Start MCP server (19 tools for IDE integration)
anots mcp:start

# Start REST API server
anots api:start

# Start API with Axiom chat endpoint
anots api:start --axiom

# Search memory
anots memory:search "your query"

# Import conversation (JSON/Markdown)
anots import conversation.json --type general

# System status
anots status

# Configuration wizard
anots setup

# Show all commands
anots --help

ダッシュボードの機能

ターミナル UI ダッシュボード（anots dashboard）では、次の機能を利用できます。

• メモリレイヤーの健全性をリアルタイムで監視
• システム統計（チャプター、セッション、メモリ）
• タイムスタンプ付きのアクティビティログ
• キーボードショートカット（F1-F3、R、Q）
• 2秒ごとの自動更新
• 90年代のBBSを彷彿とさせるサイバーパンク風のデザイン

セットアップの確認

# Check Qdrant
curl http://localhost:6333/health

# Check Redis
redis-cli ping

# Check Ollama
ollama list

開発

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint
npm run lint

# Format code
npm run format

会話のインポート

大きな会話ファイルを ANOTS メモリシステムにインポートします。

# Import Ubik conversation
npm run import -- data/import/conversation.json --type ubik

# Import Axiom conversation
npm run import -- data/import/conversation.md --type axiom

# Preview import without writing (dry run)
npm run import -- data/import/conversation.json --dry-run

# Custom chunk size (messages per chapter)
npm run import -- data/import/large-file.json --type ubik --chunk-size 100

インポートされる内容

1. Chronicle：チャプター形式の会話履歴
2. Hive Mind：検索用のセマンティックインデックス
3. Codex：抽出された真実と洞察

詳しいドキュメントと例については、data/import/README.md を参照してください。

仕様

完全な仕様については、.kiro/specs/memory-system/ を参照してください。

• requirements.md - 機能要件
• design.md - 技術設計
• tasks.md - 実装タスク

ライセンス

MIT