180 lines
4.3 KiB
Markdown
180 lines
4.3 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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`:
|
|
|
|
```toml
|
|
role_config = "~/.config/terraphim/multi_repo_roles.json"
|
|
default_role = "LearningCapture"
|
|
```
|
|
|
|
### Switching Roles
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```json
|
|
{
|
|
"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
|