Transforms TypeScript and JavaScript repos into an interactive blast radius graph with real risk scoring today. AI summaries and PR guardian workflows are planned next, after the graph loop is fully validated.
CAPABILITIES
Impact Intelligence
Instantly computes every file affected by a change using reverse Breadth-First Search — with hop distance and risk scoring at each level.
Deep Parsing
Walks every .ts/.tsx file extracting import declarations, dynamic requires, and re-exports. Resolves aliases (@/*) and relative paths precisely.
Weighted Intelligence
Four-component score: volume affected, critical node types, average importance, and proximity. Middleware always forces a HIGH override.
PR Guardian Beta
The action is wired to read real PR changed files, call the blast-radius API, and update one marked PR comment. Validate it on real repos before treating it as production-ready.
Type Intelligence
8 distinct node types detected from file path and AST content — PAGE, LAYOUT, MIDDLEWARE, HOOK, API_ROUTE, COMPONENT, UTIL, SUPABASE_CLIENT.
Coming Soon
Claude Haiku generates a business-logic summary and a technical implementation summary for every node in your graph. Summarize once, query forever.
HOW IT WORKS
walkRepo() globs all .ts/.tsx files, skips node_modules, .next, dist, and filters files under 10 bytes. Returns sorted absolute paths.
parseFile() runs @typescript-eslint/typescript-estree on each file. Extracts static imports, dynamic imports, re-exports, and require() calls.
classifyNode() applies 8 rules in order (path rules first, content rules second) to assign each file its NodeType. First match wins.
resolveImport() handles relative paths, bare paths, and @/* aliases. Tries 6 extension variants in order. Returns null for npm packages.
In-degree per node is counted across all edges. Score = (in-degree / max-in-degree) × 100. Middleware always gets the highest priority.
On PR trigger, changed files become the frontier. BFS walks the inverted edge graph, collecting all upstream dependents with hop distances.
NODE TYPES DETECTED
USE CASES
Real workflows where Sentinel replaces guesswork with graph-backed clarity.
Before any merge, see exactly how many files will be affected, which are high-risk, and what the critical propagation paths are.
New hire joins — share the graph. They explore auth, middleware, and data flows on their own, at their own pace.
Surface load-bearing middleware, circular deps, and high-importance nodes. Find structural risk before it becomes a production incident.
All high/medium/low risk nodes in one panel. Filter by type, search by file, click to inspect dependencies.
K-hops shows the neighbourhood. Blast radius shows what breaks. Refactor fast without breaking things.
Every node gets an AI-generated business summary and technical summary. Your codebase documents itself automatically.
THE AI AGE PROBLEM
Cursor, Claude Code, and Copilot let you ship faster than ever — but speed creates a new problem. Codebases grow faster than anyone can understand them. Developers merge code they didn't fully read. New hires drown in unfamiliar structure.
Sentinel turns that black box into a living, queryable blast-radius map — so your team always knows what will break, and why, before it ever merges.
AI agent edits lib/auth.ts — PR merged — authentication breaks in 14 other files no one checked.
PR opened → Sentinel posts: 🔴 HIGH RISK · 14 affected nodes · middleware impacted. Team reviews before merge.
EARLY ACCESS
GitHub integration, full AI summaries, MCP tooling, and semantic search over your graph — coming soon.
Privacy first: your code never leaves your machine. Cloud sync is always optional.