lsp-inspect

Requires the agent-lsp MCP server.

lsp-inspect

Full code quality audit for a file, package, or directory. Combines LSP batch analysis (blast_radius) with targeted per-symbol checks and LLM-driven heuristic analysis. Produces a severity-tiered findings report with confidence tiers and fix suggestions.

When to Use

• Auditing a package before a release or major refactor
• Finding dead code, untested exports, and error handling gaps in unfamiliar code
• Reviewing code quality of an external codebase for contribution opportunities
• Pre-merge quality gate on a set of changed files
• Batch inspection of an entire directory with ranked output
• Comparing branch changes against main to find newly introduced issues

Input

/lsp-inspect <target> [--checks <type1>,<type2>] [--json] [--top N] [--diff]

Target can be:

• A file path: /lsp-inspect src/handlers/auth.go
• A directory/package: /lsp-inspect internal/runnables/
• Multiple targets: /lsp-inspect pkg/a.go pkg/b.go

Directory detection: When target is a directory, walk all .go, .ts, .py files in it recursively. Produce a ranked report: "Top N findings sorted by severity then blast radius."

Flags:

• --checks <type1>,<type2>: only run listed check types (default: all applicable)
• --json: emit structured JSON instead of markdown
• --top N: Maximum findings to report (default 20). Only applies to directory/batch mode.
• --diff: Only inspect files changed vs main branch. Filter findings to lines within the diff ranges. Output header: "New issues introduced by this branch."

Check Taxonomy

Check	What it finds	LSP strategy
dead_symbol	Exported symbol with zero references	Tier 1A: blast_radius batch; Tier 1B: find_references per-symbol
test_coverage	Exported symbol with no test callers	Tier 1A: blast_radius test_callers field
silent_failure	Error/exception suppressed without re-raise or logging	Read code, identify bare except:, empty if err != nil {}, swallowed returns
error_wrapping	Error returned/raised without context	Read code, identify return err without fmt.Errorf wrapping or raise without from
coverage_gap	Unhandled input, error path, or code branch	Read code, identify switch/match without default, unchecked type assertions
doc_drift	Docstring/comment that doesn't match the actual signature	Compare inspect_symbol hover text against source
panic_not_recovered	Unhandled crash in a goroutine or async context	Read code, identify go func() without recover, unguarded .unwrap()
context_propagation	Function receives context but creates a fresh root for callees	Read code, identify context.Background() in functions with ctx parameter
unrecovered_concurrent_entry	Concurrent entry point without recovery	Read code, identify goroutines/threads/tasks without try-catch or recover
unchecked_shared_state	Type assertion or cast on concurrent data structure without safety check	Read code, identify bare .(*Type) on sync.Map, unchecked casts on ConcurrentHashMap
channel_never_closed	Channel or queue created but never closed in the same package	Read code + grep, find creation sites without matching close/shutdown
shared_field_without_sync	Field accessed from concurrent contexts without synchronization	blast_radius (sync_guarded) + find_callers (cross_concurrent)