break-anything 0.1.0 → 0.2.0

package/docs/readme/README_zh.md

@@ -4,206 +4,169 @@
 
 # Break Anything · 攻破一切
 
-### 一个 MCP,打穿代码、依赖、应用与基础设施里的漏洞。
+### 你以为你的服务很安全。你从没站在攻击者的角度看过它。
 
-**在别人动手之前先攻破它。把你的 Agent 指向你拥有的系统,找到弱点、证明它、修好它。**
+Break Anything 把你的编码 Agent 指向你自己的代码、应用和基础设施,**像攻击者一样**审视它们——挖出真正可被利用的那些、在你自己构建上证明给你看、再修掉。赶在别人先找到之前。
+
+*用攻击者的眼睛,看你自己的服务。*
 
 [![npm version](https://img.shields.io/badge/npm-break--anything-cb3837?style=flat-square)](https://www.npmjs.com/package/break-anything)
 [![MCP 工具目录](https://img.shields.io/badge/MCP-工具目录-5c4ee5?style=flat-square)](../mcp-tools.md)
 [![仅限授权目标](https://img.shields.io/badge/范围-仅限授权目标-d13438?style=flat-square)](../../DISCLAIMER.md)
 [![MIT license](https://img.shields.io/badge/license-MIT-f4c430?style=flat-square)](../../LICENSE)
 
-**[快速开始](#快速开始) · [工作原理](#工作原理) · [能测什么](#能测什么) · [演示](#演示) · [FAQ](#faq) · [配套:Patch Anything](#配套patch-anything)**
+**[快速开始](#快速开始) · [凭什么不一样](#凭什么不一样) · [30 秒看懂](#30-秒看懂) · [军火库](#军火库) · [FAQ](#faq)**
 
 <code>npx break-anything setup</code>
 
 </div>
 
 > [!IMPORTANT]
-> Break Anything 只用于检测**你拥有、或已获得明确授权**的软件。
-> 它是一个防御性、白盒的安全工具:每一条发现都附带证据和修复路径,每一个 PoC 都只打你自己的靶子。
-> 它不是攻击框架,**严禁指向任何第三方系统**。
+> Break Anything 只检测**你拥有、或已获得明确授权**的软件。每个 PoC 都只打你自己的靶子。
+> 它是防御工具,不是攻击框架,严禁指向任何第三方系统。
+
+<div align="center">
 
-> [!WARNING]
-> 只从本 README 和 `break-anything` npm 包中列出的官方来源获取 Break Anything。
-> 相似的仓库名或抄来的 README 不代表那是官方版本。
+<img src="../assets/hero.gif" alt="Break Anything" width="900" />
 
----
+</div>
 
-看到一个漏洞上了新闻,心里打鼓——*我的*项目中招了没?让你的 Agent 用 Break Anything 查一遍。
-它会检查你的代码、依赖、运行中的应用和基础设施,你不用去学十个扫描器;它告诉你**哪里**有漏洞、
-用一条可复现的发现**证明**给你看,再把修复方案交给你的 Agent,或交给
-[Patch Anything](#配套patch-anything)。
+---
 
-Break Anything 通过一个统一接口,把你的编码 Agent 接到成熟的安全工具链上(Semgrep、CodeQL、
-OSV、Trivy、Grype、Nuclei、ZAP、gitleaks 等等)。同样的能力也能在终端里直接用。分析全程本地运行,
-每条结果都带着证据、可利用性信号,以及它自身的局限。
+"应该没事吧。" 上线了、能跑、没人投诉,于是你默认它是安全的。但"还没出事"从来不是一次安全检测。唯一诚实的检测,是像攻击者那样审视你自己的服务:哪个依赖是一扇敞开的门、哪把 key 还躺在 git 历史里、哪个接口在把别人的数据交出去。
 
-大多数扫描器止步于"这是一张 CVE 列表,去升版本吧"。Break Anything 往前多走两步:它会推理一个漏洞
-**在你的实际调用路径里到底能不能打通**,对**你自己的**靶子生成 PoC,并且——**当上游根本没有修复版本时**
-——给出一个补丁、一层兼容 shim 或一个缓解方案,不让一个被遗弃的依赖变成你的事故。
+而且,安全没有终点。2026 年 10 月,一个未授权的高危 RCE 在 PHP 自己身上被挖了出来、藏了好几年(php2shell)——连撑起大半个互联网的语言都还在冒高危洞,你的应用凭什么没有。你每加一个依赖,攻击面就更大一圈,而且你补不完所有洞。所以只补攻击者*今天*真能够到的那几条。
 
-## 快速开始
+而且游戏规则刚变了:同样会写代码的 AI Agent,如今正被用来大规模地挖漏洞——攻击者手里也有。抢在他们前面,用同样的杠杆先找到你自己的洞。
 
-### 配置你的 Agent
+**Break Anything 把这双"攻击者的眼睛"交给你的编码 Agent**——一句话,只针对你拥有的软件:挖出真正可被利用的、在*你自己*构建上证明、连修复一起给你。全程本地,绝不指向任何你不拥有的东西。
 
-装好 Node.js 和 npm 后运行:
+## 快速开始
 
 ```bash
 npx break-anything setup
 ```
 
-选择你的 Agent、检视将要做的改动、确认。Setup 会注册 Break Anything 的 MCP server 并安装配套的
-工作流指令,并对现有配置做备份。完成后重启 Agent。
+选 Agent、确认改动、重启。支持 Claude Code、Codex、Cursor、Gemini CLI、Windsurf,以及任何能跑本地 MCP 的客户端。然后直接说:
 
-Setup 支持 Claude Code、Codex、Cursor、Gemini CLI、Windsurf,以及任何能运行本地 MCP server 的客户端。
+```text
+用 Break Anything 扫这个项目。只给我代码里真正可达的漏洞,证明最严重的那条,给我修复方案。
+```
 
-### 对 Agent 说
+想用终端?一行命令,今天就能跑:
 
-```text
-用 Break Anything 检查我的项目有没有漏洞。优先报在我代码里真正能被调用到的,
-在我本地构建上证明给我看,然后给我一份修复方案。
+```bash
+npx -y break-anything deps ./              # 依赖 CVE,按可达性 + EPSS 排序
+npx -y break-anything secrets ./ --history # 工作区 + 完整 git 历史里的泄露密钥
+npx -y break-anything image my-svc:latest  # 容器镜像的 OS + 应用层 CVE
+npx -y break-anything sast ./src           # 静态代码分析(注入、越权、SSRF…)
 ```
 
-把请求换成你的目标——一个仓库、一个 lockfile、一个本地运行的应用、一个容器镜像,或一个 Terraform 目录。
+## 凭什么不一样
 
-### 用终端
+扫描器都能甩你一张清单。清单本身就是问题。Break Anything 做的是清单做不到的三件事:
 
-```bash
-# 把项目依赖对 OSV / GHSA / KEV 扫一遍,带可达性 + EPSS
-npx -y break-anything deps ./ --reachability --json
+- **看可达性——它像攻击者一样思考。** 攻击者不会挨个去看你那 400 条理论 CVE,他们只冲那几条真能够到的。Break Anything 也一样:把 `confirmed`(已确认)→ `reachable`(可达)→ `present`(存在)→ `not-reachable`(不可达)分开。你从不调用的那个脆弱 `lodash` 是噪音;活代码路径上的那个才是发现。你分诊 3 条,不是 400 条。
+- **给证据,不给空话。** 不是甩一段 CVSS 描述,而是在*你自己*构建上跑出一个 PoC——那条能打穿它的具体输入或请求——把"理论上有洞"变成"这就是复现"。
+- **上游没了也给你修。** 维护者消失、没有修复版本?它给你一个补丁、一个锁版本、一层兼容 shim,或一个维护中的 fork,不让一个被遗弃的依赖变成你的事故。交给 [Patch Anything](#配套patch-anything) 还能直接出可合并的 PR。
 
-# 对注入、越权、反序列化、密钥做静态分析
-npx -y break-anything sast ./src
+它不取代 OSV、Trivy、Semgrep、ZAP——而是把它们**编排**在一个 Agent 接口下,再做它们做不了的推理。
 
-# 扫容器镜像
-npx -y break-anything image my-service:latest
-```
+## 30 秒看懂
 
-常用的话,全局安装 `brk` 命令:
+三个你会用到它的时刻,每个都是一句话丢给 Agent:
 
-```bash
-npm install --global break-anything
-brk --help
-```
+| 这一刻 | 你问 | 它给你 |
+| --- | --- | --- |
+| **"某 CVE 在刷屏——我们中招没?"** | *"扫我依赖,只标可达的。"* | 3 条可达 CVE + 修复版本,而不是 400 行的墙 |
+| **"有人提交密钥了吗?"** | *"扫仓库和 git 历史里的密钥。"* | 泄露的 key、引入它的 commit、"去轮换别只删" |
+| **"用户 A 能读到用户 B 的数据吗?"** | *"查 /orders/:id 的越权。"* | 那个 IDOR,用两个账号在 localhost 上证明给你看 |
 
-> CLI 命令是 `brk`(不是 `break`,后者是 shell 关键字)。
+## 你可以指给它什么
 
-### 更新
+你不用自己选模式。把手头的东西丢给它,它自动识别形态、路由到对应引擎。
 
-```bash
-brk update
-```
+| 你给它 | 形态 | 对应类别 |
+| --- | --- | --- |
+| 一个仓库 / 源码目录 | 源码 / 技术栈 | 依赖、代码、密钥 |
+| 一个 lockfile(`package-lock.json`、`composer.lock`、`go.mod`…) | 依赖清单 | 依赖 |
+| 一个容器镜像 | 构建产物 | 容器 |
+| 一个 APK / IPA 或编译二进制 | 构建产物 | 移动、模糊测试 |
+| 一份 Terraform / Kubernetes / Dockerfile | 配置 | 基础设施配置 |
+| 一个运行中的网址或 API(你自己的) | 活体系统 | 运行应用、API |
+| 云账号凭据(你自己的) | 活体账号 | 云配置 |
+| git 历史 | 仓库元数据 | 密钥 |
 
-## 工作原理
+## 军火库
 
-你的 Agent 通过 MCP 调用 Break Anything 去检查一个你掌控的目标。Break Anything 把每条发现连同证据、
-可利用性信号和建议的修复方式一起返回。Agent 据此排优先级、复现、修复。CLI 命令走同一套工作流。
+按**扫描类别**组织(安全团队的通用语言),每类都编排真实流水线里在跑的工具。✅ 0.1.0 已发 · 🧭 路线图。
 
-![Break Anything 流程图](../assets/break-flow.svg)
+### ✅ 今日已发
 
-调查模型:
+- **依赖(SCA)** — 整棵依赖树的已知 CVE,按可达性 + EPSS 排序,带修复版本。引擎:[OSV](https://osv.dev)、[Trivy](https://github.com/aquasecurity/trivy)、[Grype](https://github.com/anchore/grype)、pip-audit、govulncheck、composer audit。覆盖 npm/PyPI/Composer/Go/Maven/Cargo/RubyGems/NuGet。
+- **密钥(Secrets)** — 工作区 + 完整 git 历史里的泄露 key/令牌/私钥,脱敏。引擎:[Gitleaks](https://github.com/gitleaks/gitleaks)、[TruffleHog](https://github.com/trufflesecurity/trufflehog)。
+- **容器镜像** — OS + 应用层 CVE、Dockerfile 坏味道、层里的密钥。引擎:[Trivy](https://github.com/aquasecurity/trivy)、[Grype](https://github.com/anchore/grype)、[Hadolint](https://github.com/hadolint/hadolint)。
+- **静态代码(SAST)** — 注入、越权、不安全反序列化、SSRF、硬编码密钥——每条带文件/行号、CWE/OWASP 标签和命中代码片段。引擎:[Semgrep](https://semgrep.dev)。
 
-| 阶段 | 做什么 |
-| --- | --- |
-| **Find 找** | 在依赖、源码、运行中的应用、基础设施里枚举弱点。 |
-| **Prove 证** | 确认这个发现在你的用法里真的可达,并对*你的*靶子生成 PoC。 |
-| **Fix 修** | 产出补丁、锁版本、shim 或缓解方案——自己修,或交给 Patch Anything。 |
+### 🧭 路线图
 
-Break Anything 会展示它是怎么得出每个结论的。它把"已确认可利用""可达但未证明""存在但不可达"
-分开标注,而不是甩给你一堆噪音。
+- **更多 SAST 引擎** — [CodeQL](https://codeql.github.com)、SonarQube CE、Bandit(Py)、gosec(Go)、Brakeman(Rails)、Find-Sec-Bugs(Java)、security-code-scan(.NET)、retire.js(前端 JS)。
+- **基础设施与 Kubernetes(IaC)** — `apply` 前揪出公开桶、开放端口、过宽 IAM、集群配置错误。[Checkov](https://www.checkov.io)、tfsec、Terrascan、[KICS](https://kics.io)、[Kubescape](https://github.com/kubescape/kubescape)、kube-bench、[Falco](https://falco.org)(运行时)。
+- **运行应用与攻击面(DAST)** — OWASP Top 10、目录/参数发现、XSS、注入,打你授权的应用。[OWASP ZAP](https://www.zaproxy.org)、[Nuclei](https://github.com/projectdiscovery/nuclei)、[Nikto](https://github.com/sullo/nikto)、[ffuf](https://github.com/ffuf/ffuf)、[Katana](https://github.com/projectdiscovery/katana)、[Dalfox](https://github.com/hahwul/dalfox)、[sqlmap](https://sqlmap.org);攻击面测绘用 [Nmap](https://nmap.org) + [Amass](https://github.com/owasp-amass/amass) + ProjectDiscovery。
+- **API** — 越权(IDOR/BOLA)、认证绕过、批量赋值(OWASP API Top 10)。[Schemathesis](https://github.com/schemathesis/schemathesis)、ZAP。
+- **进攻 / 漏洞利用** — *仅限授权渗透;默认关闭、需显式开启、须书面授权。* 在你拥有的目标上证明可利用性。[Metasploit](https://www.metasploit.com)、sqlmap、[Hydra](https://github.com/vanhauser-thc/thc-hydra)、[Hashcat](https://hashcat.net)、[BloodHound](https://github.com/SpecterOps/BloodHound) + Impacket(域渗透)、[OpenVAS](https://www.openvas.org)。
+- **AI / 大模型安全** — 对你自己的模型和 Agent 做提示注入、越狱、数据泄露检测。[Garak](https://github.com/NVIDIA/garak)。
+- **二进制与产物分析** — 编译二进制里的已知脆弱依赖和不安全模式。[Ghidra](https://ghidra-sre.org)、[radare2](https://github.com/radareorg/radare2)、[angr](https://github.com/angr/angr)(与 REA 互补)。
+- **云配置 · 智能合约 · 移动 · 模糊测试** — [Prowler](https://github.com/prowler-cloud/prowler) · [Slither](https://github.com/crytic/slither)、Mythril、Echidna · [MobSF](https://github.com/MobSF/Mobile-Security-Framework-MobSF) · [AFL++](https://github.com/AFLplusplus/AFLplusplus)、libFuzzer、Jazzer。
 
-## 能测什么
+逐工具完整目录和 MCP 契约见 [docs/mcp-tools.md](../mcp-tools.md)。所有动态(发流量)类别**默认关闭**,拒绝任何不在白名单里的目标。
 
-| 目标 | Break Anything 返回什么 | 依赖 |
-| --- | --- | --- |
-| 依赖清单 | `package-lock`、`requirements.txt`、`go.mod`、`composer.lock`、`pom.xml`、`Cargo.toml` 里的已知 CVE;EPSS 利用概率;CISA KEV 状态;修复版本;调用路径可达性 | OSV / GHSA(内置);可达性用本地源码 |
-| 源代码 | 注入、越权、不安全反序列化、路径穿越、SSRF、硬编码密钥——带数据流证据 | Semgrep / CodeQL 规则 |
-| 仓库及 git 历史里的密钥 | 泄露的 API key、token、私钥,以及泄露的位置 | gitleaks / trufflehog 式扫描 |
-| 运行中的 Web 应用(你的主机) | 对授权的 localhost 或预发目标做 OWASP Top 10 动态检测 | Chrome 系浏览器;OWASP ZAP |
-| HTTP API(你的主机) | 越权、IDOR、认证绕过、批量赋值——带可复现请求 | 授权的 base URL + 凭据 |
-| 容器镜像 | OS 层和应用层 CVE、配置错误、镜像层里的密钥 | Trivy / Grype |
-| Dockerfile / IaC | Dockerfile、Terraform、Kubernetes、CloudFormation 里的配置错误 | Trivy / checkov 规则 |
-| 前端打包产物 | 打进浏览器的脆弱 JS 库和密钥 | Node.js + npm |
-| 编译产物 | 捆绑进去的已知脆弱依赖、内存安全隐患 | 静态检查 |
-| 智能合约(可选) | Solidity 的重入、整数溢出、权限缺口 | Slither |
-
-所有动态能力**默认关闭**,需要同时满足操作者策略和单次运行的显式授权标志。静态检查只读文件、不运行它们。
-
-## 演示
-
-十个完整 demo——**全部打在你自己拥有的、开源的、或故意做成脆弱的靶场上**。完整脚本见 [`demos/`](../../demos/)。
-
-1. **OWASP Juice Shop** — 指向授权靶场,找到一个 IDOR,用一条请求证明,讲清怎么修。
-2. **你忘了的那个依赖** — lockfile 里一个老 `lodash`/`minimist`:找到它,确认脆弱函数真的被调用,给出修复版本。
-3. **php2shell 之后的 PHP 供应链** — 一个 PHP 项目锁了脆弱的 `composer` 依赖:Break Anything 把你整条依赖链画出来,让下一个 php2shell 不会打你个措手不及。
-4. **Log4Shell 靶场** — 一个带脆弱 `log4j` 的 Java 服务:确认它从你的日志路径真的可达,而不只是"存在"。
-5. **泄露的密钥** — 一个三个月前把 AWS key 提交进去的测试仓库:在历史里找到它,算出影响面。
-6. **脆弱基础镜像** — 一个基于过期基础镜像的 `Dockerfile`:列出 OS + 应用 CVE 和最小升级方案。
-7. **公开的桶** — 一个把 S3 桶设成全网可读的 Terraform 文件:在 `apply` 之前拦住。
-8. **你自己的 Express API** — `/orders/:id` 上的一个 IDOR:用两个账号在 localhost 上证明。
-9. **重入** — 靶场里的一个 Solidity 合约:追出状态更新之前的那个外部调用。
-10. **Find → Fix 交接** — 把上面任意一条发现交给 [Patch Anything](#配套patch-anything),看它起草修复 PR。
-
-如果你攻破了什么有意思的东西(而且你有权攻破它),开个 issue 或 PR,附上目标、你的问题和你的发现。
+## 工作原理
 
-## 配套:Patch Anything
+Agent 通过 MCP 调用 Break Anything 检查一个你掌控的目标;它路由到对应引擎、确认可达性,每条结果带证据和修复返回。CLI 走同一套工作流。
 
-Break Anything 和 [Patch Anything](https://github.com/PatchAnything/patch-anything) 是一对:
+![Find Prove Fix 流程](../assets/break-flow.svg)
 
-> **Break Anything** 找出来、证明它 → **Patch Anything** 修掉它。
+**Find 找**(依赖/代码/密钥/镜像/IaC/运行应用里的弱点)→ **Prove 证**(对你的靶子生成 PoC 证明可达)→ **Fix 修**(直接修,或交给 Patch Anything)。"未发现"绝不等于"安全"。
+
+## 配套:Patch Anything
 
-当 Break Anything 报出一条发现,你的 Agent 可以直接把它递给 Patch Anything——后者生成补丁、依赖升级、
-兼容 shim,或者在上游已死时给出维护中的 fork 或本地缓解。一个是进攻味的发现,一个是防御性的修复。
-单用任一个都行,也可以把整条闭环跑通。
+> **Break Anything** 找出来、证明它 → **[Patch Anything](https://github.com/EnkiHQ/patch-anything)** 修掉它。
+
+把任意发现交给它,起草补丁、升级、shim 或 fork。发现与修复,一个闭环。
 
 ## FAQ
 
-<details>
-<summary><strong>这是攻击工具吗?会被下架吗?</strong></summary>
+<details><summary><strong>和 npm audit / Trivy / Snyk 有什么不同?</strong></summary>
 
-不是。Break Anything 是面向你拥有或已授权软件的防御性白盒工具。每个 PoC 都打你自己的靶子;
-它不附带任何针对第三方系统的武器化 exploit。见 [DISCLAIMER.md](../../DISCLAIMER.md)。
-GitHub 政策明确支持双用途安全研究。
+它们报"存在"——依赖树里任何地方存在的每个漏洞。Break Anything 多了**可达性**(是否真被调用)、**证明**(对你自己构建的 PoC)、以及上游无修复时的**自救修复**,还把依赖/代码/密钥/镜像/IaC/运行时统一到一个 Agent 接口下。
 
 </details>
 
-<details>
-<summary><strong>和 npm audit / Trivy / Snyk 有什么不同?</strong></summary>
+<details><summary><strong>它取代这些工具吗?</strong></summary>
 
-那些工具报"存在"。Break Anything 多了**可达性**(脆弱代码在你项目里是否真被调用)、**证明**
-(对你自己构建的 PoC),以及上游无修复时的**自救修复**。它还把依赖、源码、运行时、基础设施的发现
-统一到一个 Agent 接口下。
+不,它编排它们。Break Anything 是大脑和接口,OSV/Trivy/Semgrep/ZAP 是引擎。你拿到它们的深度,又不用逐个去学。
 
 </details>
 
-<details>
-<summary><strong>哪些 Agent 能用?</strong></summary>
+<details><summary><strong>这是攻击工具吗?会被下架吗?</strong></summary>
 
-任何支持本地 MCP server 的 Agent。Setup 会自动配置常见的那几个;其他的用手动 MCP 注册。
+不是。防御性、仅授权目标;每个 PoC 都打你自己的靶子,不含武器化 exploit。见 [DISCLAIMER.md](../../DISCLAIMER.md)。GitHub 政策明确支持双用途安全研究。
 
 </details>
 
-<details>
-<summary><strong>会上传我的代码吗?</strong></summary>
+<details><summary><strong>会上传我的代码吗?</strong></summary>
 
-分析在本地运行。你的 Agent 收到工具结果,它的模型提供商有自己的数据政策——那个你单独确认。
+分析在本地。Agent 收到结果,其模型提供商有自己的数据政策,单独确认。
 
 </details>
 
-<details>
-<summary><strong>能测一个我不拥有的网站吗?</strong></summary>
+<details><summary><strong>哪些 Agent 能用?</strong></summary>
 
-不能。动态能力需要显式授权标志,只用于你自己或合同授权的目标。未授权测试他人系统是违法的,也不受支持。
+任何支持本地 MCP server 的 Agent。Setup 自动配置常见的那几个。
 
 </details>
 
-## 免责声明
-
-Break Anything 用于合法的安全研究、教育,以及对你拥有或已授权软件的检测。责任使用指引见
-[DISCLAIMER.md](../../DISCLAIMER.md)。你有责任在遵守所有适用法律、以及它所编排的任何第三方工具条款的
-前提下使用本软件。
-
 ## 许可
 
-[MIT](../../LICENSE)
+[MIT](../../LICENSE)。Break 自身代码为 MIT;编排的引擎各自保留其许可证,见 [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md)。

package/docs/roadmap.md

@@ -0,0 +1,51 @@
+# Roadmap
+
+Break Anything is growing from a dependency scanner into one agent-facing interface for finding,
+proving, and fixing weaknesses across the whole surface of a project you own. Roadmap items
+describe direction, not shipped support. A new scanner joins the public workflow only once it
+produces the same finding envelope (severity, evidence, exploitability, remediation, limitations)
+as the shipped scanners.
+
+## Shipped (0.2.0)
+
+- **Supply chain / dependencies (SCA)** — npm, Composer (PHP), pip; OSV lookup, import-based
+  reachability heuristic, EPSS, fix versions.
+- **Secrets** — working tree + git history, redacted output.
+- **Container images** — via Trivy.
+- **Static code (SAST)** — via Semgrep: injection, broken access control, deserialization, SSRF,
+  with CWE/OWASP tags and the offending snippet.
+- **MCP tools** — `deps_scan`, `secrets_scan`, `image_scan`, `sast_scan`.
+
+## Next
+
+- **More SAST engines** — CodeQL, Bandit (Python), gosec (Go), Brakeman (Rails), Find-Sec-Bugs
+  (Java), security-code-scan (.NET), retire.js (frontend) — broaden language/stack coverage.
+- **Exploitability engine** — upgrade reachability from "is it imported" to "is the vulnerable
+  symbol on a real call path", and rank with EPSS + CISA KEV.
+- **IaC** — Checkov / tfsec / Terrascan / KICS over Terraform, CloudFormation, Kubernetes/Helm,
+  Dockerfile.
+- **DAST (authorized)** — OWASP ZAP + Nuclei + Nikto against your own running app.
+
+## Later
+
+- **API security** — Schemathesis (OpenAPI fuzzing) + auth-matrix prober for BOLA/IDOR, broken
+  auth, mass assignment (OWASP API Top 10).
+- **Cloud posture (CSPM)** — Prowler / ScoutSuite against your own AWS/GCP/Azure accounts.
+- **Attack surface & recon** — Nmap + Amass + ProjectDiscovery (ffuf/Katana/Dalfox) over your own domains and hosts.
+- **Offensive / exploitation (authorized pentest)** — Metasploit, Hydra, Hashcat, BloodHound + Impacket, OpenVAS. Gated, off by default, written-permission-only; turns a "reachable" finding into a proven one.
+- **AI / LLM security** — Garak-backed prompt-injection, jailbreak, and data-leakage probes for your own models and agents.
+- **Binary & artifact analysis** — Ghidra / radare2 / angr for compiled binaries and firmware (pairs with REA).
+- **Smart contracts** — Slither / Mythril / Echidna for Solidity.
+- **Mobile** — MobSF for APK/IPA.
+- **Fuzzing** — AFL++ / libFuzzer / Jazzer / Atheris with minimized reproducers.
+- **Self-remediation** — when upstream has no fix: generate a patch, pin, compatibility shim, or
+  point to a maintained fork. Deep handoff to [Patch Anything](https://github.com/EnkiHQ/patch-anything).
+- **SBOM & evidence bundles** — generate/diff SBOMs (Syft) and portable, reproducible finding
+  records that survive across sessions and gate CI.
+
+## Principles
+
+- Defensive, authorized-targets-only. Dynamic capabilities stay off by default.
+- Orchestrate trusted tools; don't reinvent scanners.
+- Signal over noise: always separate "confirmed", "reachable", and "present".
+- Honesty: absence of a finding is never reported as proof of safety.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "break-anything",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "One CLI and MCP server for coding agents to find vulnerabilities across code, dependencies, apps, and infrastructure — on targets you own or are authorized to test.",
   "type": "module",
   "keywords": [
@@ -15,15 +15,15 @@
     "reachability",
     "appsec"
   ],
-  "homepage": "https://github.com/enkiyuan/break-anything#readme",
+  "homepage": "https://github.com/EnkiHQ/break-anything#readme",
   "bugs": {
-    "url": "https://github.com/enkiyuan/break-anything/issues"
+    "url": "https://github.com/EnkiHQ/break-anything/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/enkiyuan/break-anything.git"
+    "url": "git+https://github.com/EnkiHQ/break-anything.git"
   },
-  "author": "enkiyuan",
+  "author": "EnkiHQ",
   "license": "MIT",
   "bin": {
     "brk": "bin/brk.js"

package/src/http.js

@@ -9,7 +9,7 @@ export async function fetchJson(url, { method = "GET", body, timeoutMs = 15000,
       headers: {
         "accept": "application/json",
         ...(body ? { "content-type": "application/json" } : {}),
-        "user-agent": "break-anything/0.1 (+https://github.com/BreakAnything/break-anything)",
+        "user-agent": "break-anything/0.1 (+https://github.com/EnkiHQ/break-anything)",
         ...headers,
       },
       body: body ? JSON.stringify(body) : undefined,

package/src/mcp.js

@@ -4,6 +4,7 @@ import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprot
 import { scanDependencies } from "./scan.js";
 import { scanSecrets } from "./secrets.js";
 import { scanImage } from "./image.js";
+import { scanSast } from "./sast.js";
 
 const TOOLS = [
   {
@@ -58,11 +59,27 @@ const TOOLS = [
       required: ["ref"],
     },
   },
+  {
+    name: "sast_scan",
+    description:
+      "Static application security testing (SAST) on a source tree using Semgrep. Finds injection, " +
+      "broken access control, insecure deserialization, SSRF, hardcoded secrets and more, each with " +
+      "file/line, CWE/OWASP tags, and the offending snippet. Requires Semgrep to be installed. " +
+      "Scan only code you own or are authorized to test.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Absolute path to the source tree to scan." },
+        config: { type: "string", description: "Semgrep ruleset (default p/security-audit)." },
+      },
+      required: ["path"],
+    },
+  },
 ];
 
 export async function startMcpServer() {
   const server = new Server(
-    { name: "break-anything", version: "0.1.0" },
+    { name: "break-anything", version: "0.2.0" },
     { capabilities: { tools: {} } },
   );
 
@@ -81,6 +98,9 @@ export async function startMcpServer() {
       } else if (name === "image_scan") {
         if (!strArg(args.ref)) return bad("缺少必填参数 ref。");
         result = await scanImage(args.ref);
+      } else if (name === "sast_scan") {
+        if (!strArg(args.path)) return bad("缺少必填参数 path。");
+        result = await scanSast(args.path, args.config ? { config: args.config } : {});
       } else {
         return bad(`Unknown tool: ${name}`);
       }