Directory

TCAM Memory System

Resilient 4-Layer Memory Architecture for TCAM v1.4 (Triadic Cognitive Augmentation Model)

Overview

The TCAM Memory System implements a fault-tolerant memory architecture where each layer operates independently, ensuring that system failures in one layer do not cascade to others. Memory operations are handled by a dedicated Memory Service running on Qwen 3.5 9B (local LLM).

Architecture

Four Independent Layers

• L1: Chronicle - Immutable historical record (file system, markdown)
• L2: Active Stream - Volatile working memory (Cloud LLM context + Redis)
• L3: Hive Mind - Semantic memory (Qdrant vector DB + Mem0)
• L4: Agent Codex - Personal knowledge base (file system, markdown)

Memory Service

Dedicated process running on Qwen 3.5 9B for:

• Truth extraction from dialogue
• Chronicle inscription
• Hive Mind indexing
• Agent Codex updates
• Sleeping cycle orchestration

Technology Stack

• TypeScript/Node.js - Core implementation
• Qwen 3.5 9B - Local LLM for memory operations
• Mem0 - Automatic fact extraction
• Qdrant - Vector database for semantic search
• Redis - Fast state persistence (LangGraph checkpointer)
• LangGraph - Multi-agent orchestration
• Jest - Testing framework
• fast-check - Property-based testing

Project Structure

.

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

Getting Started

Prerequisites

• Node.js 18+
• Ollama (for Qwen 3.5 9B)
• Docker (for Qdrant and Redis)

Installation

# 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 Usage

# 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

Dashboard Features

The Terminal UI dashboard (anots dashboard) provides:

• Real-time memory layer health monitoring
• System statistics (chapters, sessions, memories)
• Activity log with timestamps
• Keyboard shortcuts (F1-F3, R, Q)
• Auto-refresh every 2 seconds
• Cyberpunk aesthetic with 90s BBS vibes

Verify Setup

# Check Qdrant

curl http://localhost:6333/health

Check Redis

redis-cli ping

Check Ollama

ollama list

Development

# 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

Importing Conversations

Import large conversation files into the ANOTS memory system:

# 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

What Gets Imported

1. Chronicle: Conversation history in chapters
2. Hive Mind: Semantic indexing for search
3. Codex: Extracted truths and insights

See data/import/README.md for detailed documentation and examples.

Specification

See .kiro/specs/memory-system/ for complete specification:

• requirements.md - Functional requirements
• design.md - Technical design
• tasks.md - Implementation tasks

License

MIT