Initial commit: Multi-repository role-based knowledge graphs

2026-02-19 04:11:57 +08:00
commit 3720b9e325
19 changed files with 1218 additions and 0 deletions
@@ -0,0 +1,179 @@
+# 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