kg

---

name: kg description: Knowledge graph operations — extract entities, traverse relations, and search the graph

Knowledge graph commands:

kg extract <path> -- Extract entities and relations from source files at the given path.

1. Scan files at <path> recursively for classes, functions, modules, types, and config references
2. For each entity, record its type, name, file location, and description
3. Map relations between entities: imports, extends, implements, depends-on, calls, references
4. Store entities via mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store in the knowledge-graph namespace
5. Create causal edges via mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge for each relation
6. Report: total entities found, total relations mapped, entity type breakdown

kg traverse <entity> -- Pathfinder traversal starting from the named entity.

1. Look up the seed entity via mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-recall
2. Expand outward by following causal edges (default depth: 3)
3. Score each path: relevance = edge_weight * semantic_similarity(query, node)
4. Prune paths with cumulative score below 0.3
5. Return the top 10 paths with entities, relations, and scores

kg relations <entity> -- List all direct relations for the named entity.

1. Query causal edges where source or target matches <entity>
2. Group by relation type (imports, extends, implements, depends-on, calls)
3. Display as a table with: relation, direction (incoming/outgoing), target entity, weight

kg visualize -- Generate an ASCII visualization of the knowledge graph.

1. Recall all entities and edges from the knowledge-graph namespace
2. Identify the most-connected nodes (top 10 by degree)
3. Render a simplified graph showing key nodes and their connections
4. Include legend with entity types and relation types

kg search <query> -- Semantic search across the knowledge graph.

1. Search entities via mcp__plugin_ruflo-core_ruflo__agentdb_pattern-search (the semanticRouter controller is enabled: false in current AgentDB builds — pattern-search is the available substitute; see ruvnet/ruflo#2049)
2. Expand results with causal edges to show related context
3. Rank by pattern-match score (fall back to mcp__plugin_ruflo-core_ruflo__embeddings_generate + manual cosine for higher-fidelity semantic similarity if needed)
4. Display matches with entity name, type, file location, and relevance score