Sting

Bilbo's blade that glows blue when enemies are near. Detects problems in a FE project.

A fast CLI for static analysis of Typescript project.

Why Sting?

• Fast - Commands run pretty fast
• Static analysis - Finds issues invisible to linters
• AI-friendly - Designed for use with AI tools to reduce context

Installation

Cargo

cargo install sting

Script

Use the install.sh script to install in your machine or download the binaries from the releases list.

curl -LSfs https://anfelo.github.io/scripts/install.sh | \
    sh -s -- --git anfelo/sting

For more details about this installation script see install.sh -h

Commands

query-all

List all entities (components, services, pipes, directives, workers, etc.) in a project.

sting query-all ./my-project

query

Find a specific entity by name.

sting query ./my-project UserService
sting query ./my-project "Dashboard"

unused

Find entities that are defined but never imported anywhere.

sting unused ./my-project

graph

Output the dependency graph as JSON (D3.js compatible format).

# Output full dependency graph
sting graph ./my-project > deps.json

# Filter to specific entity types
sting graph ./my-project --entity-type component
sting graph ./my-project --entity-type component,service,directive,pipe

Options:

• --entity-type - Filter to specific entity types (comma-separated). See Entity Types for available values.

affected

List entities affected by git changes compared to a base reference.

# Basic usage - compare against main branch
sting affected ./my-project --base main

# Include transitive dependencies (multi-hop)
sting affected ./my-project --base main --transitive

# Output only directory paths (useful for test runners)
sting affected ./my-project --base main --paths

# Output full paths to test files
sting affected ./my-project --base main --tests

# Filter by project type (web, mobile, or libs)
sting affected ./my-project --base main --project web
sting affected ./my-project --base main --project libs --tests

Options:

• --base - Git reference to compare against (branch, tag, or commit SHA)
• --transitive - Include transitive consumers (multi-hop dependency traversal)
• --paths - Output only unique directory paths (without filenames)
• --tests - Output full paths to test files related to affected entities
• --project - Filter results by project type: web, mobile, or libs

chain

Find the dependency chain between two entities. Useful for understanding how components are connected.

# Find all paths from UserService to ApiClient
sting chain ./my-project --start UserService --end ApiClient

# Find only the shortest path
sting chain ./my-project --start UserService --end ApiClient --shortest

# Limit the number of paths returned
sting chain ./my-project --start UserService --end ApiClient --max-paths 10

# Limit the search depth
sting chain ./my-project --start UserService --end ApiClient --max-depth 5

Options:

• --start - Starting entity name
• --end - Ending entity name
• --shortest - Only return the shortest path (default: return all paths)
• --max-paths - Maximum number of paths to return (default: 100)
• --max-depth - Maximum path depth/length to explore (default: 10)

cycles

Detect circular dependencies in the project.

# Find circular dependencies
sting cycles ./my-project

# Limit the number of cycles reported
sting cycles ./my-project --max-cycles 50

# Limit the maximum cycle length to detect
sting cycles ./my-project --max-depth 5

Options:

• --max-cycles - Maximum number of cycles to report (default: 100)
• --max-depth - Maximum cycle length to detect (default: 10)

rank

Rank entities by various metrics. Useful for identifying components with the most or fewest dependencies.

# Rank all entities by dependency count (least to most)
sting rank ./my-project --by deps

# Rank only components
sting rank ./my-project --by deps --entity-type component

# Rank services and directives
sting rank ./my-project --by deps --entity-type service,directive

Output format (tab-separated):

0	SimpleComponent	component	/path/to/simple.component.ts
1	ButtonComponent	component	/path/to/button.component.ts
3	FormComponent	component	/path/to/form.component.ts

Options:

• --by - What to rank by. Currently supports: deps (dependency count)
• --entity-type - Filter to specific entity types (comma-separated). See Entity Types for available values.

Entity Types

Sting detects the following entity types in TypeScript/Angular projects:

Type	Description
class	Plain classes (no Angular decorator)
component	Classes decorated with @Component
service	Classes decorated with @Injectable
directive	Classes decorated with @Directive
pipe	Classes decorated with @Pipe
enum	Exported enums
type	Exported type aliases
interface	Exported interfaces
function	Exported functions
const	Exported constants
worker	Web Workers (.worker.ts files)

Status

Experimental - APIs may change.

Suported

• Angular app with a NX style monorepo

License

MIT