Metadata-Version: 2.4
Name: blasttrace
Version: 1.0.2
Summary: Pre-Edit Full-Stack Breaking-Change & Contract Blast-Radius Engine
Home-page: https://blasttrace.dev
Author: Moin Hasan
Author-email: Moin Hasan <moin_hasan@live.com>
License: Proprietary
Project-URL: Homepage, https://blasttrace.dev
Project-URL: Documentation, https://blasttrace.dev
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: C++
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Quality Assurance
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: requests>=2.28.0
Dynamic: author
Dynamic: home-page

# BlastTrace

> **Pre-Edit Full-Stack Breaking-Change & Contract Blast-Radius Engine**  
> `Database` $\leftrightarrow$ `Backend ORM` $\leftrightarrow$ `API Route` $\leftrightarrow$ `Frontend UI` $\leftrightarrow$ `Tests`

[![PyPI Version](https://img.shields.io/badge/pypi-v1.0.0-orange.svg)](https://pypi.org/project/blasttrace/)
[![Engine](https://img.shields.io/badge/engine-BlastTrace%20Native%20Core-blue.svg)](https://blasttrace.dev)
[![License](https://img.shields.io/badge/license-Commercial%20%2F%20Community-green.svg)](https://blasttrace.dev)

---

## ⚡ What is BlastTrace?

BlastTrace is a high-performance **Model Context Protocol (MCP)** server and standalone CLI that prevents AI coding agents (and human developers) from silently breaking full-stack web applications.

Existing AST tools only trace single-language file imports (`File A -> File B`). They go **100% blind** when a schema edit crosses boundaries:
```text
[Database Column: users.billing_balance]
        ↓
[Backend ORM Model: User.billing_balance]
        ↓
[API Endpoint: GET /api/v1/user/summary]
        ↓
[Frontend UI Component: CheckoutModal.tsx (data.billing_balance)]
        ↓
[Unit & E2E Tests: test_checkout.py, checkout.spec.ts]
```

BlastTrace deterministically bridges this gap using the **BlastTrace Native Core**, catching breaking changes **before** the file is saved, before `git commit`, and before pull requests merge.

---

## 🚀 Quick Start

### 1. Installation
```bash
pip install blasttrace
```
*Or run zero-install via uvx:*
```bash
uvx blasttrace
```

### 2. Standalone CLI Usage (Zero AI Required)
```bash
# Check if a proposed edit or signature change breaks downstream consumers
blasttrace check src/api/routes.py --symbol get_user_profile

# Inspect current git diff for breaking full-stack changes
blasttrace diff

# Install git pre-commit safety gate across your repo
blasttrace pre-commit --install
```

### 3. Connect to AI Agents & IDEs (Cursor, Claude Code, Windsurf, VS Code)
Add to your `claude_desktop_config.json` or `.cursor/mcp.json`:
```json
{
  "mcpServers": {
    "blasttrace": {
      "command": "blasttrace"
    }
  }
}
```

---

## 🛡️ Supported Technology Stacks

- **Database & Schemas:** PostgreSQL, MySQL, SQLite migrations (`.sql`), Prisma (`schema.prisma`), Drizzle ORM, SQLAlchemy & Django ORM (`models.py`).
- **Backend & APIs:** Python (FastAPI, Flask, Django REST, async functions, classes), Node.js / TypeScript (Express, Next.js App Router `app/api/.../route.ts`, NestJS, OpenAPI / Swagger specs).
- **Frontend Consumers:** React, Next.js, Vue, TypeScript (`.tsx`, `.ts`) calling `fetch()`, `axios`, `useSWR()`, `useQuery()`, and property destructuring.
- **Test Discovery:** Pytest, Unittest, Jest, Vitest, Playwright, Cypress.

---

## 🔑 Licensing & Tiers

| Tier | Price | Features |
| :--- | :--- | :--- |
| **Community** | **$0** (Free) | Index topology, basic single-file symbol reachability, community support |
| **Pro** | **$19/mo** (or $180/yr) | Pre-Edit Breaking-Change Gate (PASS/WARN/BLOCK), full-stack contract chains, circular dependency interceptor, 2 seats |
| **Team / CI Gate** | **$99/mo** (or $990/yr) | Everything in Pro, 5 seats, git pre-commit hook enforcement, GitHub Actions / GitLab CI PR Gate integration |

Activate your Pro license:
```bash
blasttrace activate YOUR-LICENSE-KEY
```

---

## 🔒 Security & Privacy

BlastTrace runs **100% locally and air-gapped** on your machine.
- Zero telemetry.
- Zero remote code scanning.
- Zero cloud database uploads.
- Your code never leaves your workstation.

---

© 2026 BlastTrace Inc. All rights reserved. Official website: [blasttrace.dev](https://blasttrace.dev)
