graph-retrieval

name	graph-retrieval
description	Exposes graph-based retrieval as a tool capability via `query_graph`. Reads normalized graph store files, builds a query-relevant subgraph, and returns LLM-friendly semantic triples with replayable evidence metadata.

Graph Retrieval Skill

Purpose

Expose graph-based retrieval as a tool capability without breaking the existing RepoBrain execution chain.

Tool

• query_graph(query, max_hops=2, workspace='.')

Behavior

• Reads normalized graph store files under .repobrain/graph/.
• Builds a query-relevant subgraph.
• Returns LLM-friendly semantic triples plus replayable evidence metadata.

Output Contract

{
  "summary": "...",
  "triples": [["subject", "predicate", "object"]],
  "evidence": [{"retrieval_id": "...", "tool_name": "..."}],
  "nodes": [...],
  "edges": [...]
}

Design Notes

• Keeps tool-driven and replayable architecture.
• Does not bypass pipeline.
• Intended for structure/dependency questions and context enrichment.