blastcode 0.1.0__py3-none-win_amd64.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
Binary file
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: blastcode
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Classifier: Development Status :: 4 - Beta
|
|
5
|
+
Classifier: Intended Audience :: Developers
|
|
6
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
7
|
+
Classifier: Programming Language :: Rust
|
|
8
|
+
Classifier: Programming Language :: Python :: Implementation :: CPython
|
|
9
|
+
Classifier: Topic :: Software Development :: Quality Assurance
|
|
10
|
+
Classifier: Topic :: Software Development :: Compilers
|
|
11
|
+
License-File: LICENSE
|
|
12
|
+
Summary: Incremental code-graph MCP server and blast-radius engine for AI coding agents.
|
|
13
|
+
Keywords: mcp,code-graph,blast-radius,tree-sitter,ai-agents
|
|
14
|
+
Home-Page: https://github.com/isaim0011/blastcode
|
|
15
|
+
Author: isaim0011
|
|
16
|
+
License: MIT
|
|
17
|
+
Requires-Python: >=3.8
|
|
18
|
+
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
|
|
19
|
+
Project-URL: Documentation, https://docs.rs/blastcode
|
|
20
|
+
Project-URL: Homepage, https://github.com/isaim0011/blastcode
|
|
21
|
+
Project-URL: Repository, https://github.com/isaim0011/blastcode
|
|
22
|
+
|
|
23
|
+
<div align="center">
|
|
24
|
+
|
|
25
|
+
# ⚡ BlastCode (`blast`)
|
|
26
|
+
|
|
27
|
+
**Know what breaks before your agent edits.**
|
|
28
|
+
|
|
29
|
+
[](https://crates.io/crates/blastcode)
|
|
30
|
+
[](LICENSE)
|
|
31
|
+
[](https://github.com/isaim0011/blastcode/actions)
|
|
32
|
+
[](https://modelcontextprotocol.io)
|
|
33
|
+
|
|
34
|
+
*An ultra-fast incremental code-graph engine, Model Context Protocol (MCP) server, and blast-radius analyzer for AI coding agents.*
|
|
35
|
+
|
|
36
|
+
[Features](#-key-features) • [Installation](#-installation) • [Agent Integration](#-agent-integration-mcp) • [CLI Commands](#-cli-reference) • [Languages](#-supported-languages) • [Roadmap](#-distribution-roadmap)
|
|
37
|
+
|
|
38
|
+
</div>
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## 💡 Why BlastCode?
|
|
43
|
+
|
|
44
|
+
AI coding agents waste tokens and context windows reading entire files, and they frequently make breaking changes to callers across directories because they don't know who calls what.
|
|
45
|
+
|
|
46
|
+
**BlastCode sits directly on your workspace and solves this locally:**
|
|
47
|
+
1. **Read Less**: Supplies file skeletons, single-symbol extracts, and 1-call full file context (outline + imports + dependents + recent changes).
|
|
48
|
+
2. **Blast Radius Analysis**: Tells the agent *"if I change this signature, what breaks?"* **before** the agent modifies code on disk.
|
|
49
|
+
3. **Workspace Caretaker**: A background watcher continuously diffs edits against previous AST symbols, reporting what changed in a clean digest at the start of the next tool response.
|
|
50
|
+
4. **Sub-second Speed**: Written in pure Rust with Tree-sitter and SQLite. Zero cloud roundtrips, 100% local, read-only on your codebase.
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 🚀 Installation
|
|
55
|
+
|
|
56
|
+
### Via Cargo (Recommended)
|
|
57
|
+
```bash
|
|
58
|
+
cargo install blastcode
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Via Homebrew (macOS / Linux)
|
|
62
|
+
```bash
|
|
63
|
+
brew install isaim0011/tap/blastcode
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Via Pre-built Binaries
|
|
67
|
+
Download the latest binary for Linux, macOS, or Windows directly from [GitHub Releases](https://github.com/isaim0011/blastcode/releases).
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 🤖 Agent Integration (MCP)
|
|
72
|
+
|
|
73
|
+
BlastCode works natively with any Model Context Protocol host (Claude Code, Cursor, Windsurf, Cline).
|
|
74
|
+
|
|
75
|
+
### Claude Code
|
|
76
|
+
```bash
|
|
77
|
+
claude mcp add blastcode -- blast serve --root .
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Cursor / Windsurf / Claude Desktop (`mcp.json`)
|
|
81
|
+
```json
|
|
82
|
+
{
|
|
83
|
+
"mcpServers": {
|
|
84
|
+
"blastcode": {
|
|
85
|
+
"command": "blast",
|
|
86
|
+
"args": ["serve", "--root", "/absolute/path/to/project"]
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Instruct Your Agent (`AGENTS.md` / `CLAUDE.md`)
|
|
93
|
+
Add this instruction block so your AI agent uses BlastCode instead of brute-force reading files:
|
|
94
|
+
|
|
95
|
+
```markdown
|
|
96
|
+
> Use the `blastcode` MCP tools before reading or modifying files:
|
|
97
|
+
> 1. `get_workspace_map`: Orient yourself across the project structure and exports.
|
|
98
|
+
> 2. `get_file_context` or `get_file_skeleton`: Use instead of opening and reading full files.
|
|
99
|
+
> 3. `get_symbol_source`: Retrieve the exact line range for a single function.
|
|
100
|
+
> 4. `trace_symbol`: Find all callers, callees, and type usages before refactoring.
|
|
101
|
+
> 5. `get_impact_radius`: Run with `new_source` BEFORE making an edit to verify what breaks.
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 🛠️ MCP Tools Overview
|
|
107
|
+
|
|
108
|
+
| Tool | Purpose |
|
|
109
|
+
| :--- | :--- |
|
|
110
|
+
| `get_workspace_map` | Directory tree annotated with exported symbols per file. Call first. |
|
|
111
|
+
| `get_file_context` | Skeleton + classified imports (internal vs external) + dependents + recent edits in one call. |
|
|
112
|
+
| `get_file_skeleton` | Outline of a file without function bodies, with line numbers. |
|
|
113
|
+
| `get_symbol_source` | Surgical extraction of one symbol's exact lines instead of whole-file reads. |
|
|
114
|
+
| `search_symbols` | Fuzzy symbol lookup across the entire workspace (multi-word, camelCase/snake_case). |
|
|
115
|
+
| `trace_symbol` | Definition + callers / callees / type usages tagged with confidence (`exact`, `probable`, `heuristic`). |
|
|
116
|
+
| `get_impact_radius` | Pre-edit: test proposed signature changes. Post-edit: inspect working tree vs `git HEAD`. |
|
|
117
|
+
| `query_graph` | Structural filter by kind, name, path, callers, callees, and export status. |
|
|
118
|
+
| `poll_changes` | View the change journal recorded by the caretaker background watcher. |
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## 💻 CLI Reference
|
|
123
|
+
|
|
124
|
+
You can also use `blast` directly from your terminal:
|
|
125
|
+
|
|
126
|
+
```bash
|
|
127
|
+
blast index # Build or refresh the index (.blastradius/index.db)
|
|
128
|
+
blast map # Print compact workspace map with exports
|
|
129
|
+
blast stats # View symbol, reference, and file counts
|
|
130
|
+
blast context src/lib.rs # Inspect skeleton, imports, dependents, and recent edits
|
|
131
|
+
blast skeleton src/lib.rs # View file skeleton
|
|
132
|
+
blast source my_function # Print source lines of a specific function
|
|
133
|
+
blast search "authenticate" # Fuzzy search symbols
|
|
134
|
+
blast trace verify_token # Trace callers, callees, and type usages
|
|
135
|
+
blast impact src/auth.py # Check blast radius of uncommitted changes
|
|
136
|
+
blast watch # Live terminal stream of AST-level changes
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## 🌐 Supported Languages (10 Languages)
|
|
142
|
+
|
|
143
|
+
| Tier | Languages | Grammar Feature Flag |
|
|
144
|
+
| :--- | :--- | :--- |
|
|
145
|
+
| **Core** | **Python, TypeScript, JavaScript (TSX/JSX), Rust, Go** | Included by default |
|
|
146
|
+
| **Extended** | **Java, C#, C, C++, PHP, Ruby** | Cargo features (`lang-java`, `lang-csharp`, `lang-c`, `lang-cpp`, `lang-php`, `lang-ruby`) |
|
|
147
|
+
|
|
148
|
+
*Swift and Kotlin support are scheduled next.*
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## 🗺️ Universal Ecosystem Roadmap
|
|
153
|
+
|
|
154
|
+
- [x] **v0.1.0**: Core Rust engine, 10 languages, MCP server, CLI (`blast`).
|
|
155
|
+
- [ ] **crates.io**: Official publication under `blastcode`.
|
|
156
|
+
- [ ] **PyPI / uv**: `pip install blastcode` / `uvx blastcode serve`.
|
|
157
|
+
- [ ] **npm / npx**: `npx blastcode serve`.
|
|
158
|
+
- [ ] **Homebrew Tap**: `brew install isaim0011/tap/blastcode`.
|
|
159
|
+
- [ ] **VS Code / Cursor Extension**: Embedded companion status and auto-launch.
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
## 📄 License
|
|
164
|
+
|
|
165
|
+
Licensed under the [MIT License](LICENSE).
|
|
166
|
+
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
blastcode-0.1.0.data/scripts/blast.exe,sha256=vsOA_oelvmX2Sz8OG-cEHqWza_ZqoOUF7O5ULvhPXkU,23793664
|
|
2
|
+
blastcode-0.1.0.dist-info/METADATA,sha256=m-5LTpyuvQEW0ATpS03km4IdVaMI0ZGBOqR3tMUeXus,6989
|
|
3
|
+
blastcode-0.1.0.dist-info/WHEEL,sha256=8Aej0W0a6Cz6apA3IzJrTnxLRVLAt-w0Oh8SA3Con_c,94
|
|
4
|
+
blastcode-0.1.0.dist-info/licenses/LICENSE,sha256=Nk-nJYOZ2xzM7UAoaOStslE2xTCUo4UapRWDbOU3DCA,1081
|
|
5
|
+
blastcode-0.1.0.dist-info/sboms/blastcode.cyclonedx.json,sha256=7wGTmG4dxQ41Yu6n820LoUC1nv0OdspNtiRxHd5Zpv0,98815
|
|
6
|
+
blastcode-0.1.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 BlastRadius contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|