terraphim-kg-config/README.md

Terraphim Knowledge Graph Configuration

Multi-repository role-based knowledge graphs with controlled embeddings.

Overview

This repository contains knowledge graph configurations for different projects/roles, enabling:

• Repository-specific semantic search
• Domain-specific synonym expansion
• Controlled embedding strategies
• Isolated knowledge domains

Structure

.
├── multi_repo_roles.json    # Role definitions
├── KG_ROLES.md              # Documentation
└── kg/                      # Knowledge graphs per role
    ├── terraphim-ai/        # Terraphim AI (Rust)
    ├── openclaw/            # OpenClaw (TypeScript)
    ├── last30days/          # Last30Days skill
    ├── system/              # System Operator
    └── terraphim-engineer/  # Default engineer role

Roles

1. Terraphim AI Developer

• Focus: Rust-based AI assistant development
• Thesaurus: Rust, Knowledge Graph, Agent, Search, Role
• Embeddings: local (deep)

2. OpenClaw Developer

• Focus: TypeScript gateway and agent platform
• Thesaurus: TypeScript, Gateway, Channel, Skill, Config
• Embeddings: local (standard)

3. Last30Days Skill Developer

• Focus: Claude Code skill for web research
• Thesaurus: Research, Reddit, Twitter/X, Web, Claude
• Embeddings: none (basic)

4. System Operator

• Focus: System administration and operations
• Thesaurus: Logs, Config, Service, Network, Security
• Embeddings: none (minimal)

5. Learning Capture

• Focus: Personal knowledge and learning capture
• Thesaurus: 20 concept groups (knowledge, config, git, etc.)
• Embeddings: local (deep)

6. Terraphim Engineer (Default)

• Focus: General engineering tasks
• Thesaurus: Comprehensive 20-group thesaurus
• Embeddings: local (deep)

Usage

Installation

# Clone to Terraphim config directory
git clone https://git.terraphim.cloud/kimie05c34be198a20b9/terraphim-kg-config.git ~/.config/terraphim/kg-config

# Or copy files manually
cp -r kg/* ~/.config/terraphim/kg/
cp multi_repo_roles.json ~/.config/terraphim/

Configuration

Update ~/.config/terraphim/settings.toml:

role_config = "~/.config/terraphim/multi_repo_roles.json"
default_role = "LearningCapture"

Switching Roles

# List roles
terraphim-agent roles list

# Select role
terraphim-agent roles select "Terraphim AI Developer"

# Query with synonym expansion
terraphim-agent learn query "rust"

Thesaurus Format

Each thesaurus is a JSON file mapping terms to canonical concepts:

{
  "name": "Role Name",
  "data": {
    "term1": { "id": 1, "nterm": "concept" },
    "term2": { "id": 1, "nterm": "concept" },
    "term3": { "id": 2, "nterm": "concept2" }
  }
}

Embeddings Control

Role	Model	Depth	Use Case
Terraphim AI	local	deep	Complex reasoning
OpenClaw	local	standard	Balanced
Last30Days	none	basic	Simple lookup
System Operator	none	minimal	Log analysis
Learning Capture	local	deep	Semantic memory

Synonym Groups

Knowledge (ID: 1)

learning, knowledge, lesson, insight, discovery

Configuration (ID: 2)

setup, configuration, install, deployment, initialize

Git (ID: 3)

gitea, git, github, repository, version control

AI Assistant (ID: 4)

terraphim, ai assistant, agent, claude, kimi

Tool (ID: 5)

skill, tool, capability, function, feature

Storage (ID: 6)

memory, storage, persistence, database

Context Management (ID: 7)

arscontexta, onecontext, context, progress

Retrieval (ID: 8)

search, retrieval, query, find, lookup

Failure (ID: 9)

error, failure, mistake, bug, issue, problem

Documentation (ID: 10)

documentation, docs, guide, manual, readme

Programming Languages (IDs: 11-13)

• Rust: rust, cargo
• JavaScript: javascript, js, node, npm
• Python: python, py, pip

Testing (ID: 14)

test, testing, spec, verify, validation

Security (ID: 15)

security, secure, safety, protect, guard, audit

Performance (ID: 16)

performance, speed, fast, optimize, efficiency

Build (ID: 17)

build, compile, make, package

Execution (ID: 18)

run, execute, start, launch

Debugging (ID: 19)

debug, debugging, troubleshoot, diagnose

Repair (ID: 20)

fix, repair, correct, resolve, solve

License

Apache-2.0