name	ast-introspection
description	Use Go AST-aware analysis to enumerate symbols, extract signatures, and propose mechanically safe refactors (read-only by default).
license	MIT
metadata	{"mode":"analysis","purpose":"go-ast"}

AST Introspection

Need a structure-aware view (functions, methods, types, receivers) or a safe, mechanical refactor proposal that relies on code shape rather than string matches.

Enumerates package-level declarations (funcs, methods, types, const/var) with path:line citations.
Extracts function/method signatures, receivers, and doc comments.
Lists imports and flags suspicious patterns (duplicates, likely unused groups).
Proposes minimal, mechanically-safe refactors (rename, extract, signature change) with verification steps.

Prefer read-only inspection (glob, grep, targeted read) before any edit.
Always include path:line citations for code claims.
Never perform large automated rewrites without an explicit preview, tests, and verification commands.

ast-introspection