Expand description
Library support for the devscout code-indexing CLI.
The parsing and extraction modules turn source files into fragments, the
graph and resolution modules connect those fragments, and the query and
rendering modules produce command results. The remaining modules locate
repositories, persist artifacts, and implement CLI commands and hooks.
ARCHITECTURE.md at the repository root maps every module to its
responsibility and invariants and says where a change goes.
Modulesยง
- audit
devscout audit --semantic: scoresuses-membergraph edges against a Roslyn-derived oracle.- cli
- Command-line argument parsing and dispatch.
- extract
- C# and TypeScript declaration and reference extraction.
- freshness
- Query-time index-freshness state for a programmatic (
--json) consumer. Query-time index-freshness state for a programmatic consumer. - graph
- Persisted graph and fragment data structures.
- hookio
- Agent-hook input processing.
- initcmd
- Repository initialization commands.
- manifest
- Manifest persistence, search, and index-freshness checks.
- mapcmd
- Repository mapping and incremental fragment-cache updates.
- markup
- XAML and XML markup declaration and reference extraction.
- offsets
- UTF-8 to UTF-16 source-offset conversion.
- parse
- Tree-sitter parsing and source-span collection.
- preproc
- C# conditional-compilation pre-pass: blanks the inactive arms of
#if/#elif/#else/#endifgroups before the source is parsed. - project
- Hand-scanned csproj/Directory.Build.props project model: discovery, project units, and reference closure.
- query
- Graph queries and their result models.
- render
- Text rendering for query results.
- repo
- Repository discovery and registry access.
- resolve
- Resolution of extracted C# fragments into a graph.
- store
- SQLite-backed hook freshness and content stores.
- suggest
- Symbol-name suggestions for unsuccessful queries.
- telemetry
- Query-verb telemetry: one JSON line per invocation under
SCOUT_TELEMETRY=1. - truth
- The independent semantic-truth, profile, and falsification harness. The independent semantic-truth, profile, and falsification harness.
- tsgraph
- Resolution of extracted TypeScript fragments into a graph.
- walk
- Source-tree walking and default file-purpose generation.