Know what breaks
before it ships

A pi package that traces every reference, scores the risk, and hands you a single impact report — before the change ever reaches production.

NPM

GIT

$ pi install npm:pi-blast-radius

blast-radius — impact analysis

blast radius report

## Blast Radius Report Symbol File:Line Type Risk validateToken auth.js:1 signature handleRequest api.js:4 direct requireAdmin admin.js:4 transitive valid token auth.test.js:2 test Risk score: 8/10 signature change breaks 3 callers

Why blast-radius?

Every change raises one question: what is the blast radius? This turns your pi agent into an impact analyst.

It runs git diff, greps for every caller, import, and string reference, follows the dependency chain to closure, and tells you what is likely to break and which tests to run.

No dashboards. No graphs. Just answers, in one markdown report.

Read the install guide

Install

Use pi's installer — not npm i — so the extension registers with pi.

terminal

# from npm (via pi) pi install npm:pi-blast-radius # or from git pi install git:github.com/abrahamjeron/pi_blast_radius # try without installing pi -e ./extensions/index.ts

Usage

Run it inside a pi session against any change you want to understand.

commands

/blast-radius analyze uncommitted + staged changes /blast-radius HEAD~3 analyze the last 3 commits /blast-radius <sha> analyze a specific commit /blast-radius <branch> diff a branch against its base

live run

How it works

The command injects the analysis workflow into the system prompt; pi's agent loop runs it with built-in bash, grep, and read. Read-only — no writes, no network.

Resolve the change

Runs git diff, show, and log to find changed files and symbols.

Trace references

Greps for callers, imports, and string usages — recursively to closure.

Score risk

Weighs fan-in, depth, public surface, test coverage, and churn history.

Report

Emits one markdown report with a risk score and the tests to run.