---

name: ts-ast-query description: TypeScript AST tools for querying structure and renaming symbols. Use instead of Grep when: (1) needing to understand interface/type fields before modifying code, (2) checking function signatures, (3) finding callers of a function, (4) renaming a symbol across the codebase (MUCH safer than find/replace - avoids false positives from substrings and comments).

TypeScript AST Query

Query TypeScript code structure and perform safe renames via AST parsing.

Query Usage

Copy# Find interface/type and show fields
node scripts/ast-query.js "Plan"

# Find function signature
node scripts/ast-query.js "validatePlan"

# Find what calls a function
node scripts/ast-query.js "validatePlan" --callers

Rename Usage

Rename a symbol across the entire codebase safely:

Copy# Preview rename (dry run)
node scripts/ast-query.js "Bed" --rename "GrowingBed" --dry-run

# Execute rename
node scripts/ast-query.js "Bed" --rename "GrowingBed"

The rename finds all actual references to the symbol via TypeScript's language service - no false positives from substring matches (BedGroup, bedFeet) or comments.

Output

Compact, greppable:

Copyinterface: Plan (src/lib/entities/plan.ts:45)
  id: string
  plantings: Planting[]