dsh-plugin-knowledge-graph

A DeepSeek Harness (DSH) plugin that exposes a read_graph tool backed by a codebase knowledge graph. The graph tracks every file, directory, exported symbol, and their relationships so an agent can answer structural and dependency questions faster than grepping or reading files.

Status: infancy. This project is in its infancy stage. Execution behavior, the query surface, and compatibility may change while the project is iterated on and tested by the open source community.

Derived work. This project is derived from the knowledge graph tool in Luke-Yong/H, adapted to DeepSeek Harness's "everything is a plugin" model.

What it does

Given a workspace root, the plugin builds an in-memory graph and answers queries such as:

• structure — print the full directory tree
• exports — list every symbol exported by a file
• imports_of — list symbols a file imports (with their source files)
• exporters_of — find which files export a symbol
• dependents — find which files import from a file

Graph model

The graph uses three node types and four edge types:

Nodes	Meaning
dir	A directory
file	A source file
symbol	An exported symbol (function, class, const, type, interface, enum, default)

Edges	Meaning
CONTAINS	Structural parent → child (dir → dir/file, file → symbol)
EXPORTS	File → symbol it exports
IMPORTS	File-level dependency (file → file)