BlastTrace

Pre-Edit Full-Stack Breaking-Change & Contract Blast-Radius Engine
Database Schema $\longleftrightarrow$ Backend ORM & Go Services $\longleftrightarrow$ API Contracts $\longleftrightarrow$ Web (React/Vue) $\longleftrightarrow$ Mobile (Flutter/iOS/Android) $\longleftrightarrow$ Tests

⚡ What is BlastTrace?

BlastTrace is a high-performance Model Context Protocol (FastMCP) server and standalone developer CLI that prevents AI coding agents (and engineering teams) from silently breaking full-stack web and mobile applications.

Existing linters and AST tools only trace single-language file imports (File A -> File B). They go 100% blind when a schema edit cascades across architectural boundaries:

[Database Column: users.billing_balance]
         ↓
[Backend ORM / Go Microservice: User.billing_balance]
         ↓
[API Endpoint: GET /api/v1/user/summary]
         ↓
[Web & Mobile Clients]:
  ├─ React Storefront (CheckoutModal.tsx)
  ├─ Vue / Nuxt 3 Storefront (UserProfile.vue)
  ├─ Flutter POS Client (product_model.dart)
  ├─ Native iOS App (UserProfileDto.swift)
  └─ Native Android App (UserProfileResponse.kt)
         ↓
[Targeted Test Suites: pytest, vitest, flutter test]

Powered by the BlastTrace Native Core, BlastTrace deterministically connects schema, code, network contracts, and client consumers into an actionable topology before files are saved, before git commit, and before pull requests merge.

🚀 Quick Start

1. Installation

pip install --upgrade blasttrace

Supports Windows, macOS, and Linux out-of-the-box.

2. Universal 1-Click AI Agent Setup

Automatically connect BlastTrace's 10 pre-edit safety tools to your AI coding agents in 1 single command:

blasttrace install-agent

BlastTrace automatically scans your machine and configures:

• Cursor IDE (workspace .cursor/mcp.json and global settings)
• Claude Desktop (claude_desktop_config.json)
• Claude Code CLI (~/.claude.json)
• VS Code Extensions (Cline & Roo Code)
• Windsurf (mcp_config.json)
• Zed Editor (settings.json)
• Custom Frameworks (prints standard universal MCP snippet for LangChain, LlamaIndex, Aider)

3. Standalone Developer CLI (Zero AI Required)

Run pre-edit contract reachability checks directly from your terminal:

# Check full-stack blast radius of any symbol or file
blasttrace check User.balance

# Or inspect blast radius across a specific repository
blasttrace check User.balance /path/to/repo

# Output raw JSON for custom CI/CD pipelines
blasttrace check User.balance --json

Clean Executive Terminal Output:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  BlastTrace Contract Reachability Summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Target Symbol       : User.balance
  License Tier        : PRO
  Total Blast Radius  : 28 downstream node(s)

  Downstream Breakdown by Layer:
    • Backend                 : 3 impacted
    • API                     : 5 impacted
    • Web Storefront (React)  : 7 impacted
    • Vue / Nuxt Storefront   : 2 impacted
    • Flutter POS / Client    : 3 impacted
    • iOS Client (Swift)      : 3 impacted
    • Android Client (Kotlin) : 2 impacted
    • Tests                   : 3 impacted

  Immediate Downstream Paths (Top 5):
    -> sample_backend.py (User.balance)
    -> sample_backend.py (User.balance) -> sample_backend.py (process_user_checkout)
    -> sample_backend.py (User.balance) -> sample_backend.py (get_user_profile)
    -> sample_backend.py (User.balance) -> sample_go_service.go (GET /api/v1/user)
    -> sample_backend.py (User.balance) -> sample_backend.py (GET /api/v1/user [balance])
    ... and 23 more path(s) (pass --json for full trace)

  Targeted Test Command:
    pytest sample_test.py:test_user_checkout_and_balance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

4. Git Pre-Commit Breaking-Change Gate

Install the automatic pre-commit safety gate across your repository:

blasttrace pre-commit --install

Whenever you or an AI agent attempts to stage breaking contract edits without updating client consumers, BlastTrace halts the commit and outputs the exact impacted consumers.

🛡️ Supported Technology Stacks

🔑 Licensing & Tiers

Activate your Pro or Tester key:

blasttrace activate YOUR-LICENSE-KEY

Check current license status:

blasttrace status

🔒 100% Local & Privacy-Preserving

BlastTrace executes entirely on your local machine:

• Zero telemetry: No metrics or usage sent to external servers.
• Air-gapped operation: Deterministic Dependency Reachability Engine runs locally.
• Zero cloud code uploads: Your intellectual property never leaves your workstation.

🌐 Official Links

• Website & Documentation: https://blasttrace.dev
• PyPI Package: https://pypi.org/project/blasttrace/