🛡️ BLA (Blind LLM Agents) — Adversarial defense shield that protects binaries, Electron apps, JS bundles, Python, and WebAssembly against AI reverse-engineering agents like REA. Poison -> Exhaust -> Hallucinate.
JavaScript adversarial-aiclaude-codecursorelectron-securityllm-securitymcpmcp-serverobfuscationreverse-engineeringwebassembly
docs: align README structure, 23-language bar, step-by-step prompts/commands, single SVG visual, and FAQ with REA
qybaihe39aa2aca33b2
diff --git a/README.md b/README.mdindex 5211caf..b88e178 100644--- a/README.md+++ b/README.md@@ -1,289 +1,281 @@<div align="center">-**English** · [简体中文](docs/readme/README_zh.md)+**English** · [简体中文](docs/readme/README_zh.md) · [繁體中文](docs/readme/README_zh-TW.md) · [日本語](docs/readme/README_ja.md) · [한국어](docs/readme/README_ko.md) · [Türkçe](docs/readme/README_tr.md) · [Русский](docs/readme/README_ru.md) · [Tiếng Việt](docs/readme/README_vi.md) · [ไทย](docs/readme/README_th.md) · [Deutsch](docs/readme/README_de.md) · [Español](docs/readme/README_es.md) · [Français](docs/readme/README_fr.md) · [Українська](docs/readme/README_uk.md) · [Polski](docs/readme/README_pl.md) · [Português (Brasil)](docs/readme/README_pt-BR.md) · [العربية](docs/readme/README_ar.md) · [فارسی](docs/readme/README_fa.md) · [Bahasa Indonesia](docs/readme/README_id.md) · [Italiano](docs/readme/README_it.md) · [Ελληνικά](docs/readme/README_el.md) · [മലയാളം](docs/readme/README_ml.md) · [Roman Urdu](docs/readme/README_ur-Latn.md) · [Română](docs/readme/README_ro.md)-<img src="docs/assets/bla-hero-banner.svg" alt="BLA: Blind LLM Agents — Poison -> Exhaust -> Hallucinate" width="100%" />+# BLA: Blind LLM Agents-# BLA: Blind LLM Agents (`bla-shield`)+### One MCP for defending binaries, applications, and runtime behavior against AI reverse engineering.-### One CLI, Bundler Plugin & MCP shield to defend binaries, Electron apps, JS bundles, SQLite DBs, AI models, Mobile/Game assets, Python, and WebAssembly against AI reverse-engineering agents like REA.--**Software is NOT done. It just learned how to fight back.**+**Ship a feature you built. Blind the agents trying to clone it, down to the binary level.**[](https://www.npmjs.com/package/bla-shield)-[](#mcp-server--coding-agent-integration)-[](#empirical-verification-against-morlutorea)-[](#quick-start)-[](LICENSE)+[](docs/cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](LICENSE)-[Quick Start](#quick-start) · [Before vs. After Showcase](#side-by-side-showcase-before-vs-after-bla) · [How BLA Defeats REA](#how-bla-defeats-reas-internal-analyzers) · [Token Bankruptcy Benchmark](#token-bankruptcy-benchmark) · [Supported Targets](#what-you-can-protect) · [Documentation](#documentation)+[Quick start](#quick-start) · [How BLA works](#how-bla-works) · [What you can protect](#what-you-can-protect) · [Showcases](#showcases) · [FAQ](#faq) · [Documentation](#documentation)-<code>npx bla-shield setup</code> · <code>npx bla-shield audit ./dist</code> · <code>npx bla-shield protect ./dist</code>+<code>npx bla-shield setup</code></div>----+> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).+> Follow the installation and release links from these official sources.-When [REA (Reverse Engineer Anything)](https://github.com/morluto/rea) gave coding agents one-click decompilation, static AST/IPC recovery, and Evidence ledgers (`Decompile → Understand → Recreate`), traditional variable-renaming obfuscators became obsolete overnight—because LLMs effortlessly infer semantics from control flow and string literals.+<div align="center">-**BLA (`Blind LLM Agents` / `Block Anything`)** is the open-source adversarial defense counterpart built specifically to neutralize AI reverse-engineering agents:+<br />-> **REA:** `Decompile → Understand → Recreate`-> **BLA:** `Poison → Exhaust → Hallucinate`-> ***Make Reverse Engineering Bankrupt Again.***+<img src="docs/assets/bla-vs-rea-showcase.svg" alt="Side-by-side comparison: REA reconstructing an unprotected app in 38s vs. BLA exhausting REA with 2,121x token burn and resource capacity trips" width="1200" />-Instead of heavy, expensive legacy VM packers that slow down your app, BLA strikes directly at **the structural and context-window bottlenecks of LLM coding agents and static MCP analyzers**:+<br />-1. **💥 REA Semantic Budget Breakers (Zero Runtime Cost):** Surgically triggers REA's internal static/semantic bailout thresholds (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `electron_call_paths_limited`, and `maximum_rustc_hashes > 64`), forcing REA's engine to degrade `parse_status` to `"partial"` and `examination.status` to `"limited"`.-2. **🕸️ Algorithmic Tarpits & Fake XRefs (Token Shredder):** Weaves 14–36 interconnected decoy state machines and number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) into your call graph. When an agent runs `trace_application_feature` or `build_reconstruction_obligation_ledger`, its obligation graph explodes by **15x–50x**, burning **2,000x+ more tokens** in an endless MCP paging loop.-3. **🎭 Enclave Delegation Chaff & Honey Source Maps:** Embeds benign architectural delegation manifests, ambiguous duplicate Electron IPC registrations, and valid VLQ v3 **Honey Source Maps** (`enclave://tee-runtime/`) across AST dead branches, WASM custom `"name"` sections, CPython `.pyc` marshal pools, and ELF/Mach-O/PE `.rodata` sections—causing reverse-engineering agents to conclude that core logic executes inside a hardware TEE/SGX enclave and that the local binary is merely a transport stub.+</div>----## Side-by-Side Showcase: Before vs. After BLA--<div align="center">- <img src="docs/assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect against REA" width="100%" />-</div>+Worried that someone will point [REA](https://github.com/morluto/rea) or a coding agent at your shipped product and clone your core logic in seconds? Ask your agent to harden it with BLA (`Poison → Exhaust → Hallucinate`). It audits your build without requiring source-code rewrites, shows what an attacking agent would recover, injects adversarial chaff and algorithmic tarpits, and verifies that automated reconstruction fails.-### Token Bankruptcy Benchmark+BLA connects your agent to tools for protecting native binaries, JavaScript and Electron apps, WebAssembly modules, Python bytecode, SQLite databases, AI model files, and mobile packages. You can also run the same tools from your terminal or build bundler. Protection runs locally and preserves 100% of original runtime behavior.-Run the built-in 8-target Counter-REA Showcase Benchmark yourself with `npx bla-shield benchmark`:+Setup registers BLA with your agent and installs matching workflow instructions. Every static, bytecode, and binary shield is built in—no commercial packer, external LLVM toolchain, or third-party obfuscator is required.-| Showcase Target (Modeled on REA Official Showcases) | Before BLA (REA Alone) | After `npx bla-shield protect` (Poison + Tarpit) | Token Burn Multiplier | Runtime Output Equivalence |-| :--- | :--- | :--- | :---: | :---: |-| **1. DX-Ball Sound-Pan Calculation** (`dx-ball`) | `84/100` Exposed · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` Shielded · `10,045,731` tok · **`$158.59`** (`LIMITED`) | **2,092.9x** | ✅ **100% Exact** (`0 ms` overhead) |-| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` Exposed · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` Shielded · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ **100% Exact** (`0 ms` overhead) |-| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` Exposed · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` Shielded · `10,045,833` tok · **`$158.60`** (`LIMITED`) | **2,092.9x** | ✅ **100% Exact** (`0 ms` overhead) |-| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` Exposed · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` Shielded · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ **100% Exact** (`WebAssembly.validate`) |-| **5. Native ELF64 Binary (Rust/Go/Electron Fuses/Flutter)** | `81/100` Exposed · `9,278` tok · **`$0.35`** (`COMPLETE`) | `6/100` Shielded · `2,447,631` tok · **`$39.99`** (`LIMITED`) | **263.8x** | ✅ **100% Exact** (`>64 rustc` + `>32 fuse` + `>64 dart`) |-| **6. Embedded SQLite3 App State DB** (`.sqlite`) | `84/100` Exposed · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` Shielded · `2,068,536` tok · **`$33.54`** (`LIMITED`) | **430.9x** | ✅ **100% Exact** (`SqliteColumnEvaluationFailure` trap) |-| **7. Proprietary AI Weights** (`.safetensors` / `.gguf`) | `78/100` Exposed · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` Shielded · `1,806,829` tok · **`$29.87`** (`LIMITED`) | **376.4x** | ✅ **100% Exact** (`>32 JSON/ARRAY nesting` trap) |-| **8. Mobile & Game Binaries** (`.dex` / `Il2Cpp.dat`) | `81/100` Exposed · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` Shielded · `2,046,431` tok · **`$33.23`** (`LIMITED`) | **426.3x** | ✅ **100% Exact** (Valid SHA-1 + Adler32 DEX) |+## Quick start----+### Set up your agent-## Quick Start+With Node.js and npm installed, run:-### 1. Pre-flight REA Audit (`audit`)+```bash+npx bla-shield setup+```-Before shipping your app, simulate REA's static & semantic passes on your build artifact to see exactly what REA can extract and how little it costs an attacker to clone:+Choose your agents (or pass `--all-detected --yes`), review the proposed changes, and approve them. Setup registers BLA's MCP server and installs the `blind-llm-agents` skill, with backups of existing configuration. Restart your agent afterward.++Setup supports Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI. See [installation and setup](docs/installation.md) for manual MCP registration.++### Ask your agent++Every defense stage can be triggered directly in natural language:++- **1. Audit exposure before shipping (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Inject Counter-REA protection (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify defense gates & token amplification (`Verify`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Use the terminal++Every workflow is available directly from your terminal with `npx bla-shield` (or `bla` when installed globally):++- **1. Audit a target (`audit`)** — inspect exposure score (`0–100`), exposed symbols, and estimated attacker clone cost:+ ```bash+ npx -y bla-shield@latest audit /absolute/path/to/app --json+ ```+- **2. Protect a target (`protect`)** — inject semantic budget breakers, tarpit state machines, enclave chaff, and runtime shields:+ ```bash+ npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt+ ```+- **3. Verify Counter-REA resistance (`verify`)** — check that REA's static/semantic passes hit resource limits and >10x token amplification:+ ```bash+ npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app+ ```+- **4. Run the 8-target Counter-REA benchmark (`benchmark`)**:+ ```bash+ npx -y bla-shield@latest benchmark+ ```+- **5. Emit compile-time native headers (`emit-headers`)** for C/C++, Rust, or Go builds:+ ```bash+ npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h+ ```++To install the `bla` command for regular use:```bash-npx bla-shield audit ./examples/dx-ball-sound-pan/sound-pan.js+npm install --global bla-shield+bla --help```-```text-⚠️ DANGER: Module "clampPan" in sound-pan.js is exposed to REA (84/100 exposure).- Estimated Claude Code time: 38s, cost: $0.20 to reconstruct.- Fix now: npx bla-shield protect ./examples/dx-ball-sound-pan/sound-pan.js-```+### Use in your build bundler-### 2. Inject the BLA Shield (`protect`)+Import `bla-shield/bundler` in Vite, Rollup, Webpack, or esbuild to automatically shield emitted JavaScript chunks, Honey Source Maps, and `.wasm` assets at build time:-Protect a JavaScript/TypeScript file, Electron `.asar` archive, WebAssembly `.wasm` module, Python `.py`/`.pyc`, Native ELF/Mach-O/PE binary, ZIP/APK, or an entire build directory in one command:+```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";-```bash-npx bla-shield protect ./examples/dx-ball-sound-pan/sound-pan.js -o ./sound-pan.shielded.js --intensity bankrupt+export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});```-### 3. Verify Counter-REA Resistance (`verify`)+### Update BLA-Verify that all Counter-REA gates pass (REA examination degraded to `limited`, IPC pairing unresolved, tarpit obligation graph active, and >10x token amplification):+For a CLI installed with `npm install --global` or `bun add --global`:```bash-npx bla-shield verify ./sound-pan.shielded.js ./examples/dx-ball-sound-pan/sound-pan.js+bla update```-### 4. Set Up Coding Agent Integration (`setup`)--Register BLA's MCP server and install the `blind-llm-agents` skill across Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, VS Code, OpenCode, and GitHub Copilot CLI:+`bla --update` is an alias for this workflow. If you use `npx`, refresh your agent registrations and skill with:```bash-npx bla-shield setup --all-detected --yes+npx bla-shield@latest setup```-Then simply ask your agent:+Review the setup changes and restart your agent. For one-off CLI commands, use `npx bla-shield@latest` (or `bunx bla-shield@latest`) followed by the command.-```text-Audit my dist/ folder against REA, protect all exposed modules with BLA, and verify the defense score.-```+## How BLA works----+Your agent calls BLA through MCP to audit a build artifact, inject format-specific Counter-REA shields, and verify the hardened output. When an attacking agent later inspects the protected artifact with REA, REA hits deterministic internal resource limits, drowns in decoy cross-references, and misattributes core logic to hardware enclave stubs:-## How BLA Defeats REA's Internal Analyzers+1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds benign hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 **Honey Source Maps** (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables across dead branches and constant pools.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s hardcoded analyzer caps (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) at zero runtime cost, while weaving 14–36 interconnected Fake XRef state machines into the call graph.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires in-place (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and injects the "Truman Show" runtime guard that serves synthetic enclave attestation telemetry whenever CDP, Node Inspector, Frida, or WebDriver probes attach.-<div align="center">- <img src="docs/assets/bla-architecture-flow.svg" alt="BLA 4-Layer Counter-REA Defense Architecture" width="100%" />-</div>+## What you can protect-<br />+BLA requires Node.js 22.5+ (or 24.x+) and npm. All shields run self-contained with zero external tool dependencies:-BLA was engineered by analyzing every static parser, symbolic evaluator, and resource boundary inside `morluto/rea`:--| REA Subsystem (`morluto/rea`) | REA Internal Invariant / Resource Cap | How BLA Exploits & Neutralizes It | Empirical Result on Actual REA Engine |-| :--- | :--- | :--- | :--- |-| **`javascriptSemanticResourceLimits.ts`** | `SEMANTIC_PRIMITIVE_CANDIDATE_LIMIT = 256` | Splits sensitive strings, IPC channels & route literals into $\ge 9$ conditional number-theoretic opaque chunks ($2^9 = 512 > 256$ static candidates; $O(1)$ at runtime). | REA bails out with `status: "unknown"`, `resourceLimit: "primitive-candidates"`. |-| **`javascriptSemanticRequireOrigin.ts`** | `SEMANTIC_ALIAS_SELECTION_LIMIT = 512` | Injects a 22-step inert optional-chaining selector pyramid (`a0?.x : a0?.y` $\rightarrow 2^{22}$ states) guarded by an unreachable opaque predicate. | Degrades REA `parse_status` from `"complete"` to `"partial"` & `examination.status` to `"limited"` (`"alias-selections"`). |-| **`javascriptSemanticGetterQueries.ts`** | `SEMANTIC_GETTER_EXPANSION_LIMIT = 512` | Injects a 10-field recursive getter class (`get grow() { return this.grow.more; }`) inside an unreachable guard. | Triggers `resourceLimits: ["getter-expansion"]` in REA's semantic IR. |-| **`javascriptSemanticPrimitives.ts`** | `SEMANTIC_PRIMITIVE_JSON_BYTES_LIMIT = 1_048_576` | Injects a 16-step inert string doubling chain (`s_i = s_{i-1} + s_{i-1}`) in an unreachable guard ($0$ bytes allocated at runtime). | Triggers `"primitive-bytes"` resource limit across static & semantic views. |-| **`electronStaticAnalysisIpc.ts` & `electronWrappedCallPaths.ts`** | *"Only a unique exact literal IPC channel match supports an inferred pairing."* Wrapper budget depth = `128`. | 1) Replaces real IPC channel strings with combinatorial expressions (`channel: null`).<br/>2) Registers duplicate decoy `ipcMain.handle` & `ipcRenderer.invoke` sites on the same literal channels. | `electron.ipc[0].channel === null`, `electron_call_paths_limited === true`, `uncertainty: ["dynamic-findings", "returned-reference-widening"]`. |-| **`SourceMapDecoder.ts` & `TraceSourceMap.ts`** | Automatically decodes `//# sourceMappingURL=` and `.map` files for source recovery. | Strips original source maps and injects valid VLQ v3 **Honey Source Maps** pointing to `enclave://tee-runtime/src/enclave/hardware-tpm2-bridge.ts`. | Redirects `recover_javascript_sources` and `trace_web_source_location` to decoy enclave stubs. |-| **`WabtWat.ts` & `WasmGlueAdapter.ts`** | Parses WASM custom `"name"` subsection `0` (module name) and static `.wasm` glue literals. | Strips debug sections, injects a honey `"name"` section (`tee_hardware_enclave_transport_stub_*`) + `@custom` enclave manifests, and de-literalizes `.wasm` strings in JS glue. | `inspect_wasm_artifact` surfaces decoy enclave module names while WASM executes identically. |-| **`PythonPycParser.ts`** | Walks CPython 3.7–3.14 `.pyc` marshal `TYPE_CODE` trees and `co_consts`. | Injects Python algorithmic tarpit state machines into `.py` and appends marshal-framed `TYPE_ASCII` enclave chaff records into `.pyc`. | Floods `inspect_python_pyc` with decoy code objects and enclave delegation manifests. |-| **`RustBinaryImage.ts` & `GoModuleText.ts`** | Scans read-only binary ranges for `/rustc/<40-hex>/` with hard cap `MAX_RUSTC_HASHES = 64`. | Injects 68 distinct `/rustc/<40-hex>/` commit strings into `.rodata` + decoy zlib `.dep-v0` crate graph + decoy Go `dep\t` lines. | `RustBinaryProvider` immediately fails with `Resource constraint: Read-only data contains more than 64 distinct rustc commit paths`. |-| **`ElectronFuseReader.ts`** | Scans binary slices for sentinel `dL7pKGdnNz796PbbjQWNKmHXBZaB9tsX` with `maximumSentinelsPerSlice = 32`. | Hardens real V1 fuse wires in-place (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`, `EnableEmbeddedAsarIntegrityValidation=1`) AND appends 34 decoy sentinels (`> 32`). | `inspect_electron_fuses` aborts with `ElectronFuseResourceFailure: Slice 0 contains more than 32 Electron fuse sentinels`. |-| **`FlutterPayloadScan.ts` & `DartElf.ts`** | Caps Dart AOT snapshot candidates at `MAX_SNAPSHOT_HASH_CANDIDATES = 64` and `MAX_TOOLCHAIN_LINES = 4`. | Injects 66 Dart AOT snapshot magic headers (`0xf5,0xf5,0xdc,0xdc`) with distinct 32-hex hashes, conflicting `"Dart VM version:"` strings, and 6 LLVM toolchain lines. | Forces `SnapshotHashScanner` (`capped: true`), `toolchainCapped: true`, and `conflicting-dart-version`. |-| **`SqliteDatabaseInspection.ts`** | Opens SQLite DBs in bare `readOnly: true, allowExtension: false` mode and aborts table preview on `SqliteColumnEvaluationFailure`. | Injects 3 Honey Tables (`_bla_enclave_key_hierarchy`, `_bla_tpm2_attestation_ledger`, `_bla_zero_trust_session_leases`) with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` columns. | Real app tables remain 100% queryable, while REA's `previewRows` crashes with `SqliteColumnEvaluationFailure: no such function: bla_enclave_unseal`. |-| **`SafetensorsHeader.ts` & `GgufHeader.ts`** | Enforces `MODEL_JSON_NESTING = 32` (`.safetensors`) and `MODEL_METADATA_NESTING = 32` (`.gguf`). | Embeds 35-level nested JSON/ARRAY structures (`> 32`) inside `__metadata__.bla_enclave_topology_graph` and `bla.enclave.nested_attestation_ring`. | `inspect_model_file` immediately aborts with `ModelFormatFailure (capacity): json-nesting / metadata-nesting`. |-| **Runtime CDP / Frida / Debugger attach (`runtime-shield.ts`)** | `attach_javascript_runtime`, `evaluate_javascript_runtime`, `capture_runtime_network`, `attach_native_runtime`. | Injects the **"Truman Show" Anti-CDP Runtime Shield** (detects `inspector.url()`, `--inspect`, `__frida`, `navigator.webdriver`; feeds enclave attestation telemetry to probes while preserving normal callers). | Dynamic runtime probes receive synthetic enclave transport responses instead of business state. |+| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine; [Counter-REA matrix](.agents/skills/blind-llm-agents/references/counter-rea-matrix.md) |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 integrity repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Runtime CDP / Frida | Detects `inspector.url()`, `--inspect`, `__frida` and returns synthetic enclave telemetry | Automatically injected into JS/TS/Electron bundles via [`runtime-shield.ts`](src/shields/runtime/runtime-shield.ts) |+| Source maps & HTML | Strips real maps; injects valid VLQ v3 Honey Source Maps (`enclave://tee-runtime/...`) | `bla protect index.html` · Redirects REA `recover_javascript_sources` & `trace_web_source_location` |+| Native binaries | Appends `.bla.rodata` enclave chaff, decoy symbol table entries, and multi-scanner overflow traps | `bla protect daemon.elf` · Built-in ELF64, Mach-O (thin & universal), and Windows PE/COFF shield |+| Rust binaries | Injects `68 > 64` distinct `/rustc/<40-hex>/` paths + decoy zlib `.dep-v0` crate dependency graph | `bla protect rust-bin` · Trips `RustBinaryProvider` (`MAX_RUSTC_HASHES = 64` capacity failure) |+| Go binaries | Injects decoy Go `go1.23.4` buildinfo & `dep\tgithub.com/enclave-tees/sgx-bridge` module lines | `bla protect go-bin` · Pollutes REA `inspect_go_binary` module inventory |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot magic headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` & `conflicting-dart-version` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; preserves 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` header & marshal framing shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Real tables stay 100% queryable; REA crashes with `SqliteColumnEvaluationFailure` |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & APKs | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` and recomputes SHA-1 & Adler32 | `bla protect classes.dex` or `app.apk` · Valid Dalvik/ART verification; pollutes JADX/JEB class trees |+| Unity IL2CPP metadata | Appends enclave bridge metadata and method-topology tarpits to `global-metadata.dat` (`0xFAB11BAF`) | `bla protect global-metadata.dat` · Pollutes REA `inspect_il2cpp_metadata` type/method recovery |+| C / C++ / Rust / Go src | Generates compile-time `bla_shield.h`, `bla_shield.rs`, or `bla_shield.go` with `used, noinline` tarpits | `bla emit-headers --lang c\|rust\|go` ·Compiles directly into Ghidra/Hopper/IDA decompiler views |----+## Showcases-## Empirical Verification Against `morluto/rea`--When feeding a module protected by `npx bla-shield protect` directly into `morluto/rea`'s `analyzeJavaScriptStaticSource` and `analyzeJavaScriptSemantics` engines, here is the exact raw output returned by REA:--```json-{- "parse_status": "partial",- "analysis_coverage": {- "syntax": { "status": "complete", "error_count": 0 },- "semantics": {- "unknown_findings": 4,- "uncertainty": ["dynamic-findings", "returned-reference-widening"]- },- "examination": {- "status": "limited",- "semantic_resource_limits": [- "alias-selections",- "primitive-bytes",- "primitive-candidates"- ],- "electron_call_paths_limited": true- }- },- "electron": {- "ipc": [- {- "side": "main",- "operation": "handle",- "channel": null- }- ]- }-}-```+Run `npx bla-shield benchmark` to execute all 8 counter-showcases locally and verify both REA failure modes and 100% runtime equivalence:-And when feeding a BLA-protected ELF64 binary into `morluto/rea`'s `RustBinaryProvider`:+| Showcase Target (Modeled on REA Official Showcases) | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |-```json-{- "ok": false,- "message": "Resource constraint during inspect_rust_binary: Read-only data contains more than 64 distinct rustc commit paths."-}-```+### DX-Ball: bankrupt a sound-pan reconstruction----+REA's flagship showcase reconstructs DX-Ball's `clampPan` and `calculateSoundPanFromX` helpers in seconds (`$0.20`). After running `npx bla-shield protect examples/dx-ball-sound-pan/sound-pan.js --intensity bankrupt`, REA's `parse_status` drops to `"partial"`, `examination.status` degrades to `"limited"` (`["alias-selections", "primitive-bytes", "primitive-candidates"]`), and the obligation ledger expands from 2 functions to 38 interconnected state machines (`2,121.3x` token amplification) while returning identical pan values for every input coordinate.-## What You Can Protect--| Target Format | CLI / MCP Support | What BLA Injects |-| :--- | :--- | :--- |-| **JavaScript / TypeScript** (`.js`, `.ts`, `.mjs`, `.cjs`, `.jsx`, `.tsx`) | `bla audit` / `bla protect` | Semantic Budget Breakers (`>256` primitive candidates, `>512` alias states, getter cycle), 14–36 Tarpit Functions, Fake XRefs, Route Mirage, Honey Source Maps |-| **Electron Applications** (`.asar` archives & unpacked trees) | `bla audit` / `bla protect` | Built-in Chromium Pickle `.asar` unpacker/repacker with SHA-256 block integrity, IPC channel de-literalization, ambiguous decoy IPC handlers, shadow enclave module |-| **HTML & Web Bundles** (`.html`, `.map`) | `bla audit` / `bla protect` | Inline `<script>` AST shielding + VLQ v3 Honey Source Map generation |-| **WebAssembly Modules** (`.wasm`) | `bla audit` / `bla protect` | Binary LEB128 section parser, strips debug sections, injects honey `"name"` custom section & `"bla.enclave.manifest"` custom sections |-| **Python Source & Bytecode** (`.py`, `.pyc`) | `bla audit` / `bla protect` | Python Algorithmic Tarpit state machines, number-theoretic opaque predicates, CPython `.pyc` marshal `TYPE_ASCII` constant pool chaff |-| **Native Binaries** (ELF, Mach-O, Windows PE) | `bla audit` / `bla protect` | 68 distinct `/rustc/<40-hex>/` hash overflow traps (`>64` REA cap), 34 Electron Fuse sentinels (`>32` REA cap) + V1 fuse hardening, 66 Flutter/Dart AOT snapshot hashes (`>64` REA cap), `.rodata` chaff |-| **SQLite 3 Databases** (`.sqlite`, `.sqlite3`, `.db`) | `bla audit` / `bla protect` | 3 Enclave Honey Tables + `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` trap columns that trigger `SqliteColumnEvaluationFailure` on REA's read-only inspector |-| **AI Model Files** (`.safetensors`, `.gguf`) | `bla audit` / `bla protect` | 35-level nested JSON/ARRAY header structures (`>32` REA `MODEL_JSON_NESTING` & `MODEL_METADATA_NESTING` caps) + TEE sealed weight manifests |-| **Mobile & Game Binaries** (`.dex`, `global-metadata.dat`) | `bla audit` / `bla protect` | Valid Dalvik/ART `dex\n035\0` with recomputed SHA-1 & Adler32 checksums + decoy `Lcom/enclave/sgx/...` classes; Unity IL2CPP (`0xFAB11BAF`) metadata chaff |-| **Compile-Time Native Headers** (C/C++, Rust, Go) | `bla emit-headers --lang c\|rust\|go` | Emits drop-in `bla_shield.h`, `bla_shield.rs`, or `bla_shield.go` with `__attribute__((used, noinline))` decoy tarpit functions for Ghidra/Hopper/IDA |-| **Archives & Android Packages** (`.zip`, `.apk`) | `bla audit` / `bla protect` | Injects decoy TEE/enclave attestation manifests and shadow module descriptors into ZIP/APK containers |-| **Build Bundlers** (Vite, Rollup, Webpack, esbuild) | `bla-shield/bundler` | Zero-config bundler plugins (`blaVitePlugin`, `blaRollupPlugin`, `BlaWebpackPlugin`, `blaEsbuildPlugin`) that automatically shield emitted JS chunks & `.wasm` assets |+### Notion: blind the Electron clipboard IPC bridge----+REA traces Electron apps by matching unique literal strings between `ipcRenderer.invoke("clipboard:write-rich-format")` and `ipcMain.handle(...)`. BLA replaces real IPC channel strings with $\ge 9$-chunk number-theoretic opaque expressions (`electron.ipc[0].channel === null`) and registers duplicate decoy handlers on the same literal channel names—forcing `electron_call_paths_limited: true` and `uncertainty: ["dynamic-findings", "returned-reference-widening"]`.-## CLI & Programmatic SDK Reference+### Native, SQLite & Edge AI: trip REA's binary and container capacity limits-### Global Installation or One-Shot `npx`+When an attacker runs REA's `inspect_rust_binary`, `inspect_electron_fuses`, `inspect_sqlite_database`, or `inspect_model_artifact` on BLA-protected files, REA's own parsers deterministically abort with capacity and evaluation failures (`Read-only data contains more than 64 distinct rustc commit paths`, `Slice 0 contains more than 32 Electron fuse sentinels`, `SqliteColumnEvaluationFailure`, and `ModelFormatFailure: json-nesting`).-```bash-# Run directly with npx-npx bla-shield audit ./dist-npx bla-shield protect ./dist -o ./dist-shielded --intensity bankrupt+## FAQ-# Or install globally (provides both `bla` and `bla-shield` binaries)-npm install --global bla-shield-bla --help-```+<details>+<summary><strong>Which agents can use BLA?</strong></summary>-### Generate Compile-Time C/C++, Rust, or Go Headers+Any coding agent that supports local MCP servers or `SKILL.md` workflows. `npx bla-shield setup` auto-configures Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI. See [supported agents](docs/installation.md).-```bash-bla emit-headers --lang c -o ./include/bla_shield.h-bla emit-headers --lang rust -o ./src/bla_shield.rs-bla emit-headers --lang go -o ./bla_shield.go-```+</details>-### Programmatic Node.js / TypeScript API+<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>-```typescript-import {- auditTarget,- protectTarget,- verifyTarget,- transformJavaScriptWithBlaShield,-} from "bla-shield";--const audit = auditTarget("./dist/app.asar");-console.log(`Exposure Score: ${audit.exposureScore}/100`);--const result = protectTarget({- inputPath: "./dist/app.asar",- outputPath: "./dist/app.shielded.asar",- intensity: "bankrupt",- seed: "release-2026-10",-});+No. BLA's semantic budget breakers (`alias-selections`, `getter-expansion`, `primitive-bytes`) and tarpit call graphs are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) that never execute at runtime. Every benchmark target verifies 100% input/output equivalence against the unprotected build.-const verification = verifyTarget(result.outputPath, result.inputPath);-console.log(`Defense Score: ${verification.defenseScore}/100 (${verification.tokenAmplificationFactor}x token burn)`);-```+</details>-### Vite / Rollup / Webpack / esbuild Bundler Plugins (`bla-shield/bundler`)+<details>+<summary><strong>How is BLA different from traditional obfuscators like javascript-obfuscator or O-LLVM?</strong></summary>-Automatically shield every emitted JavaScript chunk, SourceMap, and WebAssembly asset during your production build:+Traditional obfuscators rename variables (`calculatePrice` $\rightarrow$ `_0x1a2b`), which modern LLMs effortlessly reverse via control-flow semantics, while heavy VM packers slow down execution. BLA is engineered specifically against **AI coding agents and `morluto/rea`'s static/semantic analyzers**—tripping REA's exact internal resource caps, breaking IPC literal pairing, poisoning source maps/metadata with hardware-enclave delegation chaff, and multiplying agent MCP token consumption by up to 2,500x.-```typescript-// vite.config.ts-import { defineConfig } from "vite";-import { blaVitePlugin } from "bla-shield/bundler";+</details>-export default defineConfig({- plugins: [- blaVitePlugin({- intensity: "bankrupt",- enableHoneySourceMaps: true,- }),- ],-});+<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed to protect my files?</strong></summary>++No. All 19 format shields (Babel AST, Chromium `.asar`, LEB128 `.wasm`, CPython `.pyc`, ELF/Mach-O/PE, SQLite3, `.safetensors`/`.gguf`, and `.dex`/`Il2Cpp`) are built directly into `bla-shield` with zero external binary dependencies.++</details>++<details>+<summary><strong>What happens when someone runs REA against a BLA-protected app?</strong></summary>++1. REA's JavaScript/Electron analyzer degrades from `complete` to `partial` / `limited` and fails to pair IPC channels (`channel: null`).+2. REA's binary, Fuse, SQLite, and AI model inspectors hit hard capacity limits (`>64` rustc hashes, `>32` Electron fuse sentinels, `SqliteColumnEvaluationFailure`, `>32` JSON/ARRAY nesting).+3. If the agent attempts feature tracing (`trace_application_feature`), it enters 14–36 Fake XRef state machines and Honey Source Maps (`enclave://tee-runtime/`), exhausting its context window and API budget.++</details>++<details>+<summary><strong>What does installing the skill do?</strong></summary>++The [`blind-llm-agents` skill](.agents/skills/blind-llm-agents/SKILL.md) teaches your coding agent how to run pre-release Counter-REA audits, select the right protection intensity (`stealth`, `balanced`, `maximum`, `bankrupt`), integrate bundler plugins, and verify defense gates automatically.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. BLA audits, protects, and verifies all files 100% locally on your machine with deterministic seeded PRNG transforms (`--seed`) and zero network calls.++</details>++<details>+<summary><strong>What should I do if I hit a bug?</strong></summary>++Update first and run `bla doctor` to check engine readiness:++```bash+npx bla-shield@latest doctor+npx bla-shield@latest setup```----+If the issue persists, [open an issue](https://github.com/qybaihe/bla/issues) with your BLA version (`bla --version`), target format, and steps to reproduce.++</details>## Documentation-- [Installation & Agent Setup Guide](docs/installation.md)-- [Counter-REA Technical Defense Matrix](.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)-- [CLI & MCP Tool Contracts](docs/cli-and-mcp.md)-- [简体中文文档 (Simplified Chinese README)](docs/readme/README_zh.md)-- [Responsible Use & Disclaimer](DISCLAIMER.md)-- [Security Policy](SECURITY.md)+- [Installation and agent setup](docs/installation.md): agent registration, bundler plugins, updates, and uninstall.+- [CLI and MCP contracts](docs/cli-and-mcp.md): commands, options, exit codes, and JSON-RPC 2.0 MCP tool schemas.+- [Counter-REA technical defense matrix](.agents/skills/blind-llm-agents/references/counter-rea-matrix.md): exact `morluto/rea` source limits and how BLA exploits them.++Report security issues through [SECURITY.md](SECURITY.md).## Disclaimer-BLA (`bla-shield`) is a defensive software-protection and intellectual-property hardening tool designed to help software authors protect their own applications, bundles, and binaries against unauthorized automated reverse engineering. All injected chaff payloads are strictly benign architectural metadata and synthetic decoy functions that preserve 100% of the protected application's runtime behavior. See [DISCLAIMER.md](DISCLAIMER.md) for details.+See [DISCLAIMER.md](DISCLAIMER.md) for responsible-use guidance.++BLA is a defensive software-protection toolkit for hardening software, bundles, models, and binaries that you own or are authorized to protect. All injected chaff payloads are strictly benign architectural metadata and synthetic decoy functions that preserve 100% of original runtime behavior.++## Contributing++Issues and pull requests are welcome at [qybaihe/bla](https://github.com/qybaihe/bla). Run `npm run build && npm test && node dist/cli.js benchmark` before submitting changes.## Licensediff --git a/docs/assets/bla-architecture-flow.svg b/docs/assets/bla-architecture-flow.svgdeleted file mode 100644index 111b2ba..0000000--- a/docs/assets/bla-architecture-flow.svg+++ /dev/null@@ -1,73 +0,0 @@-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 320" width="100%" height="100%">- <defs>- <linearGradient id="boxGrad" x1="0%" y1="0%" x2="100%" y2="100%">- <stop offset="0%" stop-color="#0f172a" />- <stop offset="100%" stop-color="#1e1b4b" />- </linearGradient>- <style>- .mono { font-family: "JetBrains Mono", Consolas, monospace; }- .sans { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; }- </style>- </defs>-- <rect width="1200" height="320" rx="14" fill="#090d16" stroke="#1e293b" stroke-width="2" />- <text x="600" y="36" text-anchor="middle" class="sans" font-size="18" font-weight="800" fill="#f8fafc">- HOW BLA NEUTRALIZES EVERY LAYER OF THE REA REVERSE-ENGINEERING PIPELINE- </text>-- <!-- Step 1 -->- <g transform="translate(28, 62)">- <rect width="265" height="230" rx="10" fill="url(#boxGrad)" stroke="#38bdf8" stroke-width="1.5" />- <text x="18" y="30" class="mono" font-size="13" font-weight="800" fill="#38bdf8">01. SEMANTIC BUDGET BREAKER</text>- <text x="18" y="54" class="sans" font-size="12" fill="#cbd5e1">Targets REA's exact internal caps:</text>- <text x="18" y="80" class="mono" font-size="11" fill="#fde047">• primitive-candidates > 256</text>- <text x="18" y="102" class="mono" font-size="11" fill="#fde047">• alias-selections > 512</text>- <text x="18" y="124" class="mono" font-size="11" fill="#fde047">• getter-expansion > 512</text>- <text x="18" y="146" class="mono" font-size="11" fill="#fde047">• primitive-bytes > 1 MiB</text>- <text x="18" y="170" class="mono" font-size="11" fill="#fde047">• maximum_rustc_hashes > 64</text>- <rect x="18" y="186" width="229" height="30" rx="6" fill="#022c22" />- <text x="132" y="205" text-anchor="middle" class="mono" font-size="11" font-weight="700" fill="#34d399">Forces REA examination: "limited"</text>- </g>-- <!-- Step 2 -->- <g transform="translate(321, 62)">- <rect width="265" height="230" rx="10" fill="url(#boxGrad)" stroke="#818cf8" stroke-width="1.5" />- <text x="18" y="30" class="mono" font-size="13" font-weight="800" fill="#818cf8">02. ALGORITHMIC TARPIT</text>- <text x="18" y="54" class="sans" font-size="12" fill="#cbd5e1">Explodes REA's Obligation Ledger:</text>- <text x="18" y="80" class="mono" font-size="11" fill="#e2e8f0">• 14–36 Decoy State Machines</text>- <text x="18" y="102" class="mono" font-size="11" fill="#e2e8f0">• Number-Theoretic Opaque Guards</text>- <text x="18" y="124" class="mono" font-size="11" fill="#e2e8f0">• Mutual Fake XRef Call Cycles</text>- <text x="18" y="146" class="mono" font-size="11" fill="#e2e8f0">• Woven into Real Function Entry</text>- <text x="18" y="170" class="mono" font-size="11" fill="#e2e8f0">• 0 ms Runtime Execution Cost</text>- <rect x="18" y="186" width="229" height="30" rx="6" fill="#022c22" />- <text x="132" y="205" text-anchor="middle" class="mono" font-size="11" font-weight="700" fill="#34d399">30x–2500x Agent Token Burn</text>- </g>-- <!-- Step 3 -->- <g transform="translate(614, 62)">- <rect width="265" height="230" rx="10" fill="url(#boxGrad)" stroke="#c084fc" stroke-width="1.5" />- <text x="18" y="30" class="mono" font-size="13" font-weight="800" fill="#c084fc">03. IPC & SOURCEMAP MIRAGE</text>- <text x="18" y="54" class="sans" font-size="12" fill="#cbd5e1">Breaks Electron & Bundle Tracing:</text>- <text x="18" y="80" class="mono" font-size="11" fill="#e2e8f0">• De-literalizes IPC Channels</text>- <text x="18" y="102" class="mono" font-size="11" fill="#e2e8f0">• Ambiguous Decoy IPC Handlers</text>- <text x="18" y="124" class="mono" font-size="11" fill="#e2e8f0">• Decoy Enclave Route Topology</text>- <text x="18" y="146" class="mono" font-size="11" fill="#e2e8f0">• Valid VLQ Honey Source Maps</text>- <text x="18" y="170" class="mono" font-size="11" fill="#e2e8f0">• Native .asar Pack/Unpack</text>- <rect x="18" y="186" width="229" height="30" rx="6" fill="#022c22" />- <text x="132" y="205" text-anchor="middle" class="mono" font-size="11" font-weight="700" fill="#34d399">IPC Pairing: 0% Resolved</text>- </g>-- <!-- Step 4 -->- <g transform="translate(907, 62)">- <rect width="265" height="230" rx="10" fill="url(#boxGrad)" stroke="#f43f5e" stroke-width="1.5" />- <text x="18" y="30" class="mono" font-size="13" font-weight="800" fill="#fb7185">04. ENCLAVE CHAFF & BINARIES</text>- <text x="18" y="54" class="sans" font-size="12" fill="#cbd5e1">Multi-Format Binary Protection:</text>- <text x="18" y="80" class="mono" font-size="11" fill="#e2e8f0">• TEE/SGX Delegation Mirage</text>- <text x="18" y="102" class="mono" font-size="11" fill="#e2e8f0">• WASM Custom "name" Section</text>- <text x="18" y="124" class="mono" font-size="11" fill="#e2e8f0">• CPython .pyc Marshal Chaff</text>- <text x="18" y="146" class="mono" font-size="11" fill="#e2e8f0">• ELF/Mach-O/PE Section Shield</text>- <text x="18" y="170" class="mono" font-size="11" fill="#e2e8f0">• C / Rust / Go Compile Headers</text>- <rect x="18" y="186" width="229" height="30" rx="6" fill="#022c22" />- <text x="132" y="205" text-anchor="middle" class="mono" font-size="11" font-weight="700" fill="#34d399">Full Multi-Runtime Coverage</text>- </g>-</svg>diff --git a/docs/assets/bla-hero-banner.svg b/docs/assets/bla-hero-banner.svgdeleted file mode 100644index 79988aa..0000000--- a/docs/assets/bla-hero-banner.svg+++ /dev/null@@ -1,89 +0,0 @@-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 380" width="100%" height="100%">- <defs>- <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">- <stop offset="0%" stop-color="#090d16" />- <stop offset="50%" stop-color="#0f172a" />- <stop offset="100%" stop-color="#171026" />- </linearGradient>- <linearGradient id="shieldGrad" x1="0%" y1="0%" x2="100%" y2="100%">- <stop offset="0%" stop-color="#22d3ee" />- <stop offset="50%" stop-color="#818cf8" />- <stop offset="100%" stop-color="#f43f5e" />- </linearGradient>- <linearGradient id="goldGrad" x1="0%" y1="0%" x2="100%" y2="0%">- <stop offset="0%" stop-color="#fbbf24" />- <stop offset="100%" stop-color="#f97316" />- </linearGradient>- <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">- <feGaussianBlur stdDeviation="8" result="blur" />- <feComposite in="SourceGraphic" in2="blur" operator="over" />- </filter>- <style>- .title { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; font-weight: 900; fill: #f8fafc; }- .mono { font-family: "JetBrains Mono", "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace; }- .pulse { animation: pulseAnim 2.8s infinite ease-in-out; }- @keyframes pulseAnim {- 0%, 100% { opacity: 0.85; }- 50% { opacity: 1; }- }- </style>- </defs>-- <!-- Background -->- <rect width="1200" height="380" rx="18" fill="url(#bgGrad)" stroke="#334155" stroke-width="2" />-- <!-- Subtle Grid -->- <g stroke="#1e293b" stroke-width="1" opacity="0.55">- <line x1="0" y1="76" x2="1200" y2="76" />- <line x1="0" y1="152" x2="1200" y2="152" />- <line x1="0" y1="228" x2="1200" y2="228" />- <line x1="0" y1="304" x2="1200" y2="304" />- <line x1="240" y1="0" x2="240" y2="380" />- <line x1="480" y1="0" x2="480" y2="380" />- <line x1="720" y1="0" x2="720" y2="380" />- <line x1="960" y1="0" x2="960" y2="380" />- </g>-- <!-- Top Pill Badge -->- <rect x="370" y="26" width="460" height="32" rx="16" fill="#1e1b4b" stroke="#6366f1" stroke-width="1.5" />- <text x="600" y="47" text-anchor="middle" class="mono" font-size="13" font-weight="700" fill="#a5b4fc">- ⚡ ADVERSARIAL DEFENSE SHIELD AGAINST AI REVERSE ENGINEERING- </text>-- <!-- Main Title -->- <text x="600" y="122" text-anchor="middle" class="title" font-size="56" letter-spacing="-1">- BLA: <tspan fill="url(#shieldGrad)">Blind LLM Agents</tspan>- </text>-- <!-- Subtitle -->- <text x="600" y="162" text-anchor="middle" class="title" font-size="22" font-weight="600" fill="#94a3b8">- Software is NOT done. It just learned how to fight back.- </text>-- <!-- Duel Comparison Pill Box -->- <!-- Left: REA -->- <rect x="110" y="195" width="450" height="92" rx="12" fill="#1c1917" stroke="#7f1d1d" stroke-width="1.5" />- <text x="135" y="225" class="mono" font-size="13" font-weight="700" fill="#f87171">THE SPEAR — REA (Reverse Engineer Anything)</text>- <text x="135" y="255" class="mono" font-size="19" font-weight="700" fill="#fca5a5" text-decoration="line-through">- Decompile → Understand → Recreate- </text>- <text x="135" y="276" class="mono" font-size="12" fill="#a8a29e">Extracts AST, IPC, WAT, .pyc & native pseudocode via MCP</text>-- <!-- Center VS Badge -->- <circle cx="600" cy="241" r="24" fill="#0f172a" stroke="url(#shieldGrad)" stroke-width="2.5" filter="url(#glow)" />- <text x="600" y="247" text-anchor="middle" class="title" font-size="16" fill="#38bdf8">VS</text>-- <!-- Right: BLA -->- <rect x="640" y="195" width="450" height="92" rx="12" fill="#042f2e" stroke="#14b8a6" stroke-width="2" class="pulse" />- <text x="665" y="225" class="mono" font-size="13" font-weight="700" fill="#2dd4bf">THE SHIELD — BLA (Blind LLM Agents / Block Anything)</text>- <text x="665" y="255" class="mono" font-size="19" font-weight="800" fill="url(#goldGrad)">- Poison → Exhaust → Hallucinate- </text>- <text x="665" y="276" class="mono" font-size="12" fill="#99f6e4">Breaks REA semantic budgets, weaves tarpits & bankrupts tokens</text>-- <!-- Bottom Command Bar -->- <rect x="290" y="312" width="620" height="44" rx="10" fill="#020617" stroke="#38bdf8" stroke-width="1.5" />- <text x="600" y="340" text-anchor="middle" class="mono" font-size="16" font-weight="700" fill="#e2e8f0">- <tspan fill="#38bdf8">$</tspan> npx bla-shield audit ./dist && npx bla-shield protect ./dist- </text>-</svg>diff --git a/docs/readme/README_ar.md b/docs/readme/README_ar.mdnew file mode 100644index 0000000..be23246--- /dev/null+++ b/docs/readme/README_ar.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · **العربية** · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### خادم MCP واحد لحماية الملفات الثنائية والتطبيقات وسلوك وقت التشغيل ضد الهندسة العكسية بالذكاء الاصطناعي.++**احمِ الميزات التي بنيتها. أعمِ وكلاء الذكاء الاصطناعي الذين يحاولون استنساخها حتى المستوى الثنائي.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[البدء السريع](#quick-start) · [كيف يعمل BLA](#how-bla-works) · [ما يمكنك حمايته](#what-you-can-protect) · [دراسات الحالة والاختبارات](#showcases) · [الأسئلة الشائعة (FAQ)](#faq) · [التوثيق](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++هل تقلق من استخدام [REA](https://github.com/morluto/rea) لاستنساخ تطبيقك في ثوانٍ؟ اطلب من وكيلك تحصينه باستخدام BLA (`Poison → Exhaust → Hallucinate`).++يربط BLA وكيلك بأدوات حماية الملفات الثنائية وتطبيقات JavaScript وElectron وWebAssembly وPython وقواعد بيانات SQLite ونماذج الذكاء الاصطناعي محلياً مع الحفاظ على سلوك التشغيل بنسبة 100%.++<a id="quick-start"></a>++## البدء السريع++### إعداد الوكيل++```bash+npx bla-shield setup+```++### اطلب من وكيلك++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### استخدام الطرفية++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### الاستخدام في أداة الحزم++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### تحديث BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## كيف يعمل BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## ما يمكنك حمايته++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## دراسات الحالة والاختبارات++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## الأسئلة الشائعة (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## التوثيق++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_de.md b/docs/readme/README_de.mdnew file mode 100644index 0000000..b22c979--- /dev/null+++ b/docs/readme/README_de.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · **Deutsch** · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Ein MCP zum Schutz von Binärdateien, Anwendungen und Laufzeitverhalten gegen KI-gestütztes Reverse Engineering.++**Schützen Sie Ihre Features. Machen Sie KI-Agenten bis auf die Binärebene blind.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Schnellstart](#quick-start) · [Wie BLA funktioniert](#how-bla-works) · [Was Sie schützen können](#what-you-can-protect) · [Showcases & Benchmarks](#showcases) · [Häufige Fragen (FAQ)](#faq) · [Dokumentation](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Befürchten Sie, dass jemand [REA](https://github.com/morluto/rea) auf Ihre ausgelieferte App ansetzt und Ihre Kernlogik in Sekunden klont? Härten Sie Ihren Build mit BLA (`Poison → Exhaust → Hallucinate`).++BLA verbindet Ihren Agenten mit Schutzwerkzeugen für native Binärdateien, JavaScript- und Electron-Apps, WebAssembly, Python-Bytecode, SQLite-Datenbanken und KI-Modelle – 100 % lokal und ohne Laufzeiteinbußen.++<a id="quick-start"></a>++## Schnellstart++### Agent einrichten++```bash+npx bla-shield setup+```++### Agenten beauftragen++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Terminal verwenden++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Im Bundler verwenden++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### BLA aktualisieren++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Wie BLA funktioniert++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Was Sie schützen können++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Showcases & Benchmarks++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Häufige Fragen (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Dokumentation++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_el.md b/docs/readme/README_el.mdnew file mode 100644index 0000000..30f8c68--- /dev/null+++ b/docs/readme/README_el.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · **Ελληνικά** · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Ένα ενιαίο MCP για την προστασία εκτελέσιμων αρχείων, εφαρμογών και συμπεριφοράς εκτέλεσης από αντίστροφηวิศวกรรม AI.++**Προστατέψτε τις λειτουργίες που δημιουργήσατε. Τυφλώστε τους πράκτορες AI που προσπαθούν να τις κλωνοποιήσουν σε δυαδικό επίπεδο.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Γρήγορη εκκίνηση](#quick-start) · [Πώς λειτουργεί το BLA](#how-bla-works) · [Τι μπορείτε να προστατέψετε](#what-you-can-protect) · [Παρουσιάσεις & Benchmarks](#showcases) · [Συχνές Ερωτήσεις (FAQ)](#faq) · [Τεκμηρίωση](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Ανησυχείτε μήπως κάποιος χρησιμοποιήσει το [REA](https://github.com/morluto/rea) για να κλωνοποιήσει την εφαρμογή σας σε δευτερόλεπτα; Ζητήστε από τον πράκτορά σας να την θωρακίσει με το BLA (`Poison → Exhaust → Hallucinate`).++Το BLA προστατεύει εγγενή δυαδικά αρχεία, εφαρμογές JavaScript και Electron, WebAssembly, Python bytecode, βάσεις δεδομένων SQLite και μοντέλα AI τοπικά, διατηρώντας 100% τη συμπεριφορά εκτέλεσης.++<a id="quick-start"></a>++## Γρήγορη εκκίνηση++### Ρυθμίστε τον πράκτορά σας++```bash+npx bla-shield setup+```++### Ρωτήστε τον πράκτορά σας++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Χρήση τερματικού++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Χρήση στον bundler σας++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Ενημέρωση BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Πώς λειτουργεί το BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Τι μπορείτε να προστατέψετε++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Παρουσιάσεις & Benchmarks++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Συχνές Ερωτήσεις (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Τεκμηρίωση++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_es.md b/docs/readme/README_es.mdnew file mode 100644index 0000000..19716e4--- /dev/null+++ b/docs/readme/README_es.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · **Español** · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Un único MCP para defender binarios, aplicaciones y comportamiento en tiempo de ejecución contra la ingeniería inversa con IA.++**Protege las funciones que creaste. Ciega a los agentes que intentan clonarlas hasta el nivel binario.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Inicio rápido](#quick-start) · [Cómo funciona BLA](#how-bla-works) · [Qué puedes proteger](#what-you-can-protect) · [Casos de estudio y Benchmarks](#showcases) · [Preguntas frecuentes (FAQ)](#faq) · [Documentación](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++¿Te preocupa que alguien use [REA](https://github.com/morluto/rea) para clonar tu aplicación en segundos? Pídele a tu agente que la blinde con BLA (`Poison → Exhaust → Hallucinate`).++BLA conecta tu agente con herramientas para proteger binarios nativos, aplicaciones JavaScript y Electron, módulos WebAssembly, bytecode de Python, bases de datos SQLite y modelos de IA localmente, preservando el 100% del comportamiento original.++<a id="quick-start"></a>++## Inicio rápido++### Configura tu agente++```bash+npx bla-shield setup+```++### Pídele a tu agente++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Usa la terminal++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Úsalo en tu bundler++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Actualizar BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Cómo funciona BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Qué puedes proteger++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Casos de estudio y Benchmarks++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Preguntas frecuentes (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Documentación++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_fa.md b/docs/readme/README_fa.mdnew file mode 100644index 0000000..33e1fee--- /dev/null+++ b/docs/readme/README_fa.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · **فارسی** · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### یک MCP واحد برای دفاع از فایلهای باینری، برنامهها و رفتار زمان اجرا در برابر مهندسی معکوس هوش مصنوعی.++**ویژگیهایی را که ساختهاید ایمن کنید. ایجنتهایی را که قصد کلون کردن آن را دارند در سطح باینری کور کنید.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[شروع سریع](#quick-start) · [نحوه کار BLA](#how-bla-works) · [چه چیزهایی را میتوانید محافظت کنید](#what-you-can-protect) · [نمونهها و بنچمارکها](#showcases) · [سوالات متداول (FAQ)](#faq) · [مستندات](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++نگران هستید کسی با استفاده از [REA](https://github.com/morluto/rea) برنامه شما را در چند ثانیه کلون کند؟ از ایجنت خود بخواهید آن را با BLA (`Poison → Exhaust → Hallucinate`) ایمن سازد.++BLA ایجنت شما را به ابزارهای محافظت از باینریهای بومی، برنامههای JavaScript و Electron، ماژولهای WebAssembly، بایتکد Python، پایگاههای داده SQLite و مدلهای هوش مصنوعی متصل میکند.++<a id="quick-start"></a>++## شروع سریع++### راهاندازی ایجنت++```bash+npx bla-shield setup+```++### درخواست از ایجنت++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### استفاده از ترمینال++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### استفاده در باندلر++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### بهروزرسانی BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## نحوه کار BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## چه چیزهایی را میتوانید محافظت کنید++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## نمونهها و بنچمارکها++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## سوالات متداول (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## مستندات++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_fr.md b/docs/readme/README_fr.mdnew file mode 100644index 0000000..35d170e--- /dev/null+++ b/docs/readme/README_fr.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · **Français** · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Un seul MCP pour défendre vos binaires, applications et comportements d'exécution contre la rétro-ingénierie par IA.++**Expédiez vos fonctionnalités. Aveuglez les agents qui tentent de les cloner, jusqu'au niveau binaire.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Démarrage rapide](#quick-start) · [Comment fonctionne BLA](#how-bla-works) · [Ce que vous pouvez protéger](#what-you-can-protect) · [Études de cas et Benchmarks](#showcases) · [FAQ](#faq) · [Documentation](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Vous craignez qu'un attaquant utilise [REA](https://github.com/morluto/rea) pour cloner votre application en quelques secondes ? Demandez à votre agent de la protéger avec BLA (`Poison → Exhaust → Hallucinate`).++BLA connecte votre agent à des outils de protection pour binaires natifs, applications JavaScript et Electron, WebAssembly, bytecode Python, bases SQLite et modèles d'IA, 100 % en local et sans impact sur l'exécution.++<a id="quick-start"></a>++## Démarrage rapide++### Configurer votre agent++```bash+npx bla-shield setup+```++### Demander à votre agent++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Utiliser le terminal++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Utiliser dans votre bundler++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Mettre à jour BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Comment fonctionne BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Ce que vous pouvez protéger++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Études de cas et Benchmarks++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## FAQ++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Documentation++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_id.md b/docs/readme/README_id.mdnew file mode 100644index 0000000..97cce26--- /dev/null+++ b/docs/readme/README_id.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · **Bahasa Indonesia** · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Satu MCP untuk melindungi biner, aplikasi, dan perilaku runtime dari rekayasa balik AI.++**Rilis fitur yang Anda bangun. Butakan agen AI yang mencoba mengkloningnya hingga ke level biner.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Mulai cepat](#quick-start) · [Cara kerja BLA](#how-bla-works) · [Apa yang dapat Anda lindungi](#what-you-can-protect) · [Showcase & Benchmark](#showcases) · [FAQ](#faq) · [Dokumentasi](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Khawatir seseorang menggunakan [REA](https://github.com/morluto/rea) untuk mengkloning aplikasi Anda dalam hitungan detik? Minta agen Anda melindunginya dengan BLA (`Poison → Exhaust → Hallucinate`).++BLA menghubungkan agen Anda ke alat pelindung biner asli, aplikasi JavaScript & Electron, WebAssembly, bytecode Python, database SQLite, dan model AI secara lokal dengan mempertahankan 100% perilaku runtime.++<a id="quick-start"></a>++## Mulai cepat++### Siapkan agen Anda++```bash+npx bla-shield setup+```++### Minta agen Anda++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Gunakan terminal++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Gunakan di bundler Anda++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Perbarui BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Cara kerja BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Apa yang dapat Anda lindungi++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Showcase & Benchmark++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## FAQ++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Dokumentasi++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_it.md b/docs/readme/README_it.mdnew file mode 100644index 0000000..71889e0--- /dev/null+++ b/docs/readme/README_it.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · **Italiano** · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Un unico MCP per difendere binari, applicazioni e comportamento runtime dal reverse engineering basato su IA.++**Proteggi le funzionalità che hai creato. Acceca gli agenti che cercano di clonarle, fino al livello binario.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Avvio rapido](#quick-start) · [Come funziona BLA](#how-bla-works) · [Cosa puoi proteggere](#what-you-can-protect) · [Casi di studio e Benchmark](#showcases) · [Domande frequenti (FAQ)](#faq) · [Documentazione](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Temi che qualcuno usi [REA](https://github.com/morluto/rea) per clonare la tua app in pochi secondi? Chiedi al tuo agente di blindarla con BLA (`Poison → Exhaust → Hallucinate`).++BLA collega il tuo agente a strumenti per proteggere binari nativi, app JavaScript ed Electron, WebAssembly, bytecode Python, database SQLite e modelli IA localmente, preservando il 100% del comportamento runtime.++<a id="quick-start"></a>++## Avvio rapido++### Configura il tuo agente++```bash+npx bla-shield setup+```++### Chiedi al tuo agente++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Usa il terminale++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Usa nel tuo bundler++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Aggiorna BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Come funziona BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Cosa puoi proteggere++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Casi di studio e Benchmark++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Domande frequenti (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Documentazione++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_ja.md b/docs/readme/README_ja.mdnew file mode 100644index 0000000..426854f--- /dev/null+++ b/docs/readme/README_ja.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · **日本語** · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### バイナリ、アプリケーション、ランタイム動作を AI リバースエンジニアリングから防御する単一の MCP & CLI シールド。++**あなたが作った機能を守り抜く。バイナリレベルで AI エージェントの複製を無力化する。**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[クイックスタート](#quick-start) · [BLA の仕組み](#how-bla-works) · [保護できるターゲット](#what-you-can-protect) · [ショーケースとベンチマーク](#showcases) · [よくある質問 (FAQ)](#faq) · [ドキュメント](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++[REA](https://github.com/morluto/rea) やコーディングエージェントにアプリを解析され、数秒でコアロジックを複製されるのを防ぎたいですか?エージェントに BLA(`Poison → Exhaust → Hallucinate`)でビルド成果物を保護させましょう。ソースコードの書き換えなしで露出度を監査し、エンクレーブのデコイとアルゴリズム・ターピットを注入して、自動再構築を確実に失敗させます。++BLA はネイティブバイナリ、JavaScript / Electron アプリ、WebAssembly、Python バイトコード、SQLite データベース、AI モデル(GGUF / safetensors)、モバイルパッケージの保護ツールにエージェントを接続します。処理はすべてローカルで実行され、元のランタイム動作を 100% 維持します。++<a id="quick-start"></a>++## クイックスタート++### エージェントのセットアップ++```bash+npx bla-shield setup+```++### エージェントへの指示プロンプト++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### ターミナルでの使用++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### バンドラープラグインでの使用++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### BLA のアップデート++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## BLA の仕組み++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## 保護できるターゲット++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## ショーケースとベンチマーク++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## よくある質問 (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## ドキュメント++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_ko.md b/docs/readme/README_ko.mdnew file mode 100644index 0000000..1d283f0--- /dev/null+++ b/docs/readme/README_ko.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · **한국어** · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### 바이너리, 애플리케이션, 런타임 동작을 AI 리버스 엔지니어링으로부터 방어하는 단일 MCP 및 CLI 실드.++**직접 만든 핵심 기능을 보호하세요. 바이너리 레벨에서 복제를 시도하는 AI 에이전트를 무력화합니다.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[빠른 시작](#quick-start) · [BLA 작동 방식](#how-bla-works) · [보호 가능한 대상](#what-you-can-protect) · [쇼케이스 및 벤치마크](#showcases) · [자주 묻는 질문 (FAQ)](#faq) · [문서](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++[REA](https://github.com/morluto/rea)나 코딩 에이전트가 배포된 앱을 분석해 몇 초 만에 핵심 로직을 복제하는 것이 걱정되시나요? 에이전트에게 BLA(`Poison → Exhaust → Hallucinate`)로 빌드를 보호하도록 지시하세요. 소스 코드 수정 없이 노출도를 감사하고, 엔클레이브 채프와 알고리즘 타르핏을 주입하여 자동 재구성을 차단합니다.++BLA는 네이티브 바이너리, JavaScript 및 Electron 앱, WebAssembly, Python 바이트코드, SQLite 데이터베이스, AI 모델, 모바일 패키지를 보호하는 도구를 에이전트에 연결합니다. 모든 보호 작업은 로컬에서 실행되며 원래의 런타임 동작을 100% 유지합니다.++<a id="quick-start"></a>++## 빠른 시작++### 에이전트 설정++```bash+npx bla-shield setup+```++### 에이전트에게 요청하기++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### 터미널에서 사용하기++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### 번들러에서 사용하기++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### BLA 업데이트++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## BLA 작동 방식++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## 보호 가능한 대상++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## 쇼케이스 및 벤치마크++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## 자주 묻는 질문 (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## 문서++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_ml.md b/docs/readme/README_ml.mdnew file mode 100644index 0000000..ba91a50--- /dev/null+++ b/docs/readme/README_ml.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · **മലയാളം** · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### AI റിവേഴ്സ് എഞ്ചിനീയറിംഗിൽ നിന്ന് ബൈനറികളെയും ആപ്ലിക്കേഷനുകളെയും സംരക്ഷിക്കുന്നതിനുള്ള ഏക MCP ഷീൽഡ്.++**നിങ്ങൾ നിർമ്മിച്ച ഫീച്ചർ സുരക്ഷിതമാക്കുക. അത് പകർത്താൻ ശ്രമിക്കുന്ന AI ഏജന്റുകളെ ബൈനറി തലത്തിൽ തടയുക.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[വേഗത്തിൽ തുടങ്ങാം](#quick-start) · [BLA എങ്ങനെ പ്രവർത്തിക്കുന്നു](#how-bla-works) · [എന്തൊക്കെ സംരക്ഷിക്കാം](#what-you-can-protect) · [ഷോകേസുകളും ബെഞ്ച്മാർക്കുകളും](#showcases) · [പതിവ് ചോദ്യങ്ങൾ (FAQ)](#faq) · [ഡോക്യുമെന്റേഷൻ](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++[REA](https://github.com/morluto/rea) ഉപയോഗിച്ച് നിങ്ങളുടെ ആപ്പ് നിമിഷങ്ങൾക്കുള്ളിൽ ക്ലോൺ ചെയ്യപ്പെടുമെന്ന് ആശങ്കയുണ്ടോ? BLA (`Poison → Exhaust → Hallucinate`) ഉപയോഗിച്ച് ബിൽഡ് സുരക്ഷിതമാക്കാൻ നിങ്ങളുടെ ഏജന്റിനോട് ആവശ്യപ്പെടുക.++നേറ്റീവ് ബൈനറികൾ, JavaScript/Electron ആപ്പുകൾ, WebAssembly, Python ബൈറ്റ്കോഡ്, SQLite ഡാറ്റാബേസുകൾ, AI മോഡലുകൾ എന്നിവ 100% റൺടൈം കൃത്യതയോടെ പ്രാദേശികമായി സംരക്ഷിക്കാൻ BLA സഹായിക്കുന്നു.++<a id="quick-start"></a>++## വേഗത്തിൽ തുടങ്ങാം++### ഏജന്റ് സജ്ജമാക്കുക++```bash+npx bla-shield setup+```++### ഏജന്റിനോട് ആവശ്യപ്പെടുക++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### ടെർമിനൽ ഉപയോഗിക്കുക++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### ബണ്ട്ലറിൽ ഉപയോഗിക്കുക++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### BLA അപ്ഡേറ്റ് ചെയ്യുക++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## BLA എങ്ങനെ പ്രവർത്തിക്കുന്നു++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## എന്തൊക്കെ സംരക്ഷിക്കാം++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## ഷോകേസുകളും ബെഞ്ച്മാർക്കുകളും++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## പതിവ് ചോദ്യങ്ങൾ (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## ഡോക്യുമെന്റേഷൻ++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_pl.md b/docs/readme/README_pl.mdnew file mode 100644index 0000000..8310009--- /dev/null+++ b/docs/readme/README_pl.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · **Polski** · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Jeden serwer MCP do ochrony plików binarnych, aplikacji i zachowania runtime przed inżynierią wsteczną AI.++**Chroń stworzone przez siebie funkcje. Oślepiaj agentów AI próbujących je sklonować, aż do poziomu binarnego.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Szybki start](#quick-start) · [Jak działa BLA](#how-bla-works) · [Co możesz chronić](#what-you-can-protect) · [Przykłady i benchmarki](#showcases) · [FAQ](#faq) · [Dokumentacja](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Obawiasz się, że ktoś użyje [REA](https://github.com/morluto/rea), aby sklonować Twoją aplikację w kilka sekund? Zabezpiecz swój build za pomocą BLA (`Poison → Exhaust → Hallucinate`).++BLA łączy Twojego agenta z narzędziami do ochrony natywnych plików binarnych, aplikacji JavaScript i Electron, WebAssembly, bajtkodu Pythona, baz SQLite oraz modeli AI lokalnie, zachowując 100% oryginalnego działania.++<a id="quick-start"></a>++## Szybki start++### Skonfiguruj agenta++```bash+npx bla-shield setup+```++### Poproś swojego agenta++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Użyj terminala++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Użyj w bundlerze++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Aktualizacja BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Jak działa BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Co możesz chronić++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Przykłady i benchmarki++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## FAQ++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Dokumentacja++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_pt-BR.md b/docs/readme/README_pt-BR.mdnew file mode 100644index 0000000..1ed1afa--- /dev/null+++ b/docs/readme/README_pt-BR.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · **Português (Brasil)** · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Um único MCP para defender binários, aplicações e comportamento em tempo de execução contra engenharia reversa por IA.++**Entregue o recurso que você criou. Cegue os agentes que tentam cloná-lo, até o nível binário.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Início rápido](#quick-start) · [Como o BLA funciona](#how-bla-works) · [O que você pode proteger](#what-you-can-protect) · [Showcases e Benchmarks](#showcases) · [Perguntas frequentes (FAQ)](#faq) · [Documentação](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Preocupado que alguém aponte o [REA](https://github.com/morluto/rea) para o seu aplicativo e clone sua lógica em segundos? Peça ao seu agente para blindá-lo com o BLA (`Poison → Exhaust → Hallucinate`).++O BLA conecta seu agente a ferramentas para proteger binários nativos, apps JavaScript e Electron, WebAssembly, bytecode Python, bancos SQLite e modelos de IA localmente, preservando 100% do comportamento em tempo de execução.++<a id="quick-start"></a>++## Início rápido++### Configure seu agente++```bash+npx bla-shield setup+```++### Peça ao seu agente++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Use o terminal++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Use no seu bundler++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Atualizar o BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Como o BLA funciona++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## O que você pode proteger++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Showcases e Benchmarks++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Perguntas frequentes (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Documentação++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_ro.md b/docs/readme/README_ro.mdnew file mode 100644index 0000000..c289655--- /dev/null+++ b/docs/readme/README_ro.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · **Română**++# BLA: Blind LLM Agents++### Un singur MCP pentru protejarea fișierelor binare, aplicațiilor și comportamentului runtime împotriva ingineriei inverse cu AI.++**Lansează funcționalitatea pe care ai construit-o. Orbește agenții care încearcă să o cloneze, până la nivel binar.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Pornire rapidă](#quick-start) · [Cum funcționează BLA](#how-bla-works) · [Ce poți proteja](#what-you-can-protect) · [Studii de caz și Benchmark-uri](#showcases) · [Întrebări frecvente (FAQ)](#faq) · [Documentație](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Te îngrijorează că cineva va folosi [REA](https://github.com/morluto/rea) pentru a-ți clona aplicația în câteva secunde? Cere-i agentului tău să o protejeze cu BLA (`Poison → Exhaust → Hallucinate`).++BLA conectează agentul tău la instrumente pentru protejarea fișierelor binare native, aplicațiilor JavaScript și Electron, WebAssembly, bytecode Python, bazelor de date SQLite și modelelor AI local, păstrând 100% comportamentul original.++<a id="quick-start"></a>++## Pornire rapidă++### Configurează agentul++```bash+npx bla-shield setup+```++### Cere-i agentului tău++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Folosește terminalul++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Folosește în bundler++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Actualizează BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Cum funcționează BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Ce poți proteja++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Studii de caz și Benchmark-uri++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Întrebări frecvente (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Documentație++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_ru.md b/docs/readme/README_ru.mdnew file mode 100644index 0000000..f54efb5--- /dev/null+++ b/docs/readme/README_ru.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · **Русский** · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Единый MCP и CLI щит для защиты бинарных файлов, приложений и рантайма от ИИ-агентов обратного инжиниринга.++**Защитите созданную вами функциональность. Ослепите ИИ-агентов на бинарном уровне.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Быстрый старт](#quick-start) · [Как работает BLA](#how-bla-works) · [Что можно защитить](#what-you-can-protect) · [Примеры и бенчмарки](#showcases) · [Частые вопросы (FAQ)](#faq) · [Документация](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Опасаетесь, что [REA](https://github.com/morluto/rea) или ИИ-агент скопирует логику вашего приложения за считанные секунды? Поручите вашему агенту защитить сборку с помощью BLA (`Poison → Exhaust → Hallucinate`).++BLA подключает вашего агента к инструментам защиты нативных бинарных файлов, приложений JavaScript и Electron, модулей WebAssembly, байт-кода Python, баз данных SQLite и ИИ-моделей. Защита работает локально и на 100% сохраняет исходное поведение программы.++<a id="quick-start"></a>++## Быстрый старт++### Настройка агента++```bash+npx bla-shield setup+```++### Запросы к агенту++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Использование в терминале++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Интеграция со сборщиками++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Обновление BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Как работает BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Что можно защитить++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Примеры и бенчмарки++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Частые вопросы (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Документация++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_th.md b/docs/readme/README_th.mdnew file mode 100644index 0000000..4b787a7--- /dev/null+++ b/docs/readme/README_th.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · **ไทย** · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### หนึ่ง MCP สำหรับปกป้องไบนารี แอปพลิเคชัน และพฤติกรรมรันไทม์จากการทำวิศวกรรมย้อนกลับด้วย AI++**ปกป้องฟีเจอร์ที่คุณสร้าง ทำให้เอเจนต์ AI ที่พยายามลอกเลียนแบบมืดบอดตั้งแต่ระดับไบนารี**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[เริ่มต้นอย่างรวดเร็ว](#quick-start) · [BLA ทำงานอย่างไร](#how-bla-works) · [สิ่งที่คุณปกป้องได้](#what-you-can-protect) · [กรณีศึกษาและผลการทดสอบ](#showcases) · [คำถามที่พบบ่อย (FAQ)](#faq) · [เอกสารประกอบ](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++กังวลว่าจะมีคนใช้ [REA](https://github.com/morluto/rea) เพื่อคัดลอกแอปของคุณในไม่กี่วินาทีใช่ไหม? สั่งให้เอเจนต์ของคุณปกป้องบิลด์ด้วย BLA (`Poison → Exhaust → Hallucinate`)++BLA เชื่อมต่อเอเจนต์เข้ากับเครื่องมือปกป้องไบนารีเนทีฟ, แอป JavaScript และ Electron, WebAssembly, Python bytecode, ฐานข้อมูล SQLite และโมเดล AI โดยทำงานแบบออฟไลน์ 100%++<a id="quick-start"></a>++## เริ่มต้นอย่างรวดเร็ว++### ตั้งค่าเอเจนต์ของคุณ++```bash+npx bla-shield setup+```++### สั่งงานเอเจนต์ของคุณ++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### ใช้งานผ่านเทอร์มินัล++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### ใช้งานใน Bundler++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### อัปเดต BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## BLA ทำงานอย่างไร++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## สิ่งที่คุณปกป้องได้++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## กรณีศึกษาและผลการทดสอบ++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## คำถามที่พบบ่อย (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## เอกสารประกอบ++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_tr.md b/docs/readme/README_tr.mdnew file mode 100644index 0000000..c02661c--- /dev/null+++ b/docs/readme/README_tr.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · **Türkçe** · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### İkili dosyaları, uygulamaları ve çalışma zamanı davranışını yapay zeka tersine mühendisliğine karşı koruyan tek MCP kalkanı.++**Geliştirdiğiniz özelliği koruyun. Kopyalamaya çalışan ajanları ikili düzeyde kör edin.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Hızlı başlangıç](#quick-start) · [BLA nasıl çalışır](#how-bla-works) · [Neleri koruyabilirsiniz](#what-you-can-protect) · [Vitrin ve Kıyaslamalar](#showcases) · [SSS (FAQ)](#faq) · [Dokümantasyon](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++[REA](https://github.com/morluto/rea) veya bir kodlama ajanının uygulamanızı saniyeler içinde kopyalamasından mı endişeleniyorsunuz? Ajanınızdan BLA (`Poison → Exhaust → Hallucinate`) ile yapınızı güçlendirmesini isteyin.++BLA; yerel ikili dosyaları, JavaScript ve Electron uygulamalarını, WebAssembly modüllerini, Python bayt kodunu, SQLite veritabanlarını ve AI modellerini yerel olarak korur ve çalışma zamanı davranışını %100 korur.++<a id="quick-start"></a>++## Hızlı başlangıç++### Ajanınızı kurun++```bash+npx bla-shield setup+```++### Ajanınıza sorun++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Terminali kullanın++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Derleyici eklentisi olarak kullanın++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### BLA'yı güncelleyin++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## BLA nasıl çalışır++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Neleri koruyabilirsiniz++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Vitrin ve Kıyaslamalar++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## SSS (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Dokümantasyon++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_uk.md b/docs/readme/README_uk.mdnew file mode 100644index 0000000..c4f6b6a--- /dev/null+++ b/docs/readme/README_uk.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · **Українська** · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Єдиний MCP для захисту бінарних файлів, застосунків та поведінки під час виконання від ШІ-реверс-інжинірингу.++**Захистіть створені вами функції. Засліпіть агентів, що намагаються їх скопіювати, на бінарному рівні.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Швидкий старт](#quick-start) · [Як працює BLA](#how-bla-works) · [Що можна захистити](#what-you-can-protect) · [Приклади та бенчмарки](#showcases) · [Часті запитання (FAQ)](#faq) · [Документація](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Хвилюєтеся, що хтось використає [REA](https://github.com/morluto/rea), щоб клонувати ваш продукт за лічені секунди? Захистіть збірку за допомогою BLA (`Poison → Exhaust → Hallucinate`).++BLA захищає нативні бінарні файли, застосунки JavaScript та Electron, WebAssembly, байт-код Python, бази даних SQLite та ШІ-моделі локально зі 100% збереженням поведінки під час виконання.++<a id="quick-start"></a>++## Швидкий старт++### Налаштуйте свого агента++```bash+npx bla-shield setup+```++### Запитайте свого агента++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Використання термінала++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Інтеграція з бандлером++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Оновлення BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Як працює BLA++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Що можна захистити++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Приклади та бенчмарки++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Часті запитання (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Документація++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_ur-Latn.md b/docs/readme/README_ur-Latn.mdnew file mode 100644index 0000000..e5b82df--- /dev/null+++ b/docs/readme/README_ur-Latn.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · **Roman Urdu** · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Binaries, applications aur runtime behavior ko AI reverse engineering se bachane ke liye aik MCP shield.++**Apna banaya hua feature mehfooz rakhein. Clone karne wale AI agents ko binary level par andha karein.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Quick start](#quick-start) · [BLA kaise kaam karta hai](#how-bla-works) · [Aap kya protect kar sakte hain](#what-you-can-protect) · [Showcases aur Benchmarks](#showcases) · [Sawalaat (FAQ)](#faq) · [Documentation](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Kya aap ko fikar hai ke koi [REA](https://github.com/morluto/rea) ya coding agent aap ki app ko chand seconds mein clone kar le ga? Apne agent se kahein ke woh BLA (`Poison → Exhaust → Hallucinate`) ke zariye build ko mehfooz banaye.++BLA native binaries, JavaScript aur Electron apps, WebAssembly, Python bytecode, SQLite databases aur AI models ko locally protect karta hai aur 100% runtime behavior barqarar rakhta hai.++<a id="quick-start"></a>++## Quick start++### Apna agent set up karein++```bash+npx bla-shield setup+```++### Apne agent se kahein++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Terminal istemal karein++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Bundler mein istemal karein++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### BLA update karein++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## BLA kaise kaam karta hai++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Aap kya protect kar sakte hain++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Showcases aur Benchmarks++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Sawalaat (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Documentation++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_vi.md b/docs/readme/README_vi.mdnew file mode 100644index 0000000..ccffe9b--- /dev/null+++ b/docs/readme/README_vi.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · **Tiếng Việt** · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### Một MCP duy nhất để bảo vệ tệp nhị phân, ứng dụng và hành vi runtime trước các tác nhân AI dịch ngược.++**Bảo vệ tính năng bạn xây dựng. Làm mù các tác nhân AI đang cố sao chép nó ngay từ cấp độ nhị phân.**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[Bắt đầu nhanh](#quick-start) · [Cách BLA hoạt động](#how-bla-works) · [Những gì bạn có thể bảo vệ](#what-you-can-protect) · [Showcase & Benchmark](#showcases) · [Câu hỏi thường gặp (FAQ)](#faq) · [Tài liệu](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++Lo ngại ai đó dùng [REA](https://github.com/morluto/rea) để sao chép ứng dụng của bạn trong vài giây? Hãy yêu cầu tác nhân của bạn bảo vệ bản dựng bằng BLA (`Poison → Exhaust → Hallucinate`).++BLA bảo vệ tệp nhị phân gốc, ứng dụng JavaScript và Electron, WebAssembly, Python bytecode, cơ sở dữ liệu SQLite và mô hình AI hoàn toàn cục bộ, giữ nguyên 100% hành vi runtime.++<a id="quick-start"></a>++## Bắt đầu nhanh++### Thiết lập tác nhân++```bash+npx bla-shield setup+```++### Yêu cầu tác nhân++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### Sử dụng終端 (Terminal)++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### Tích hợp Bundler++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### Cập nhật BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## Cách BLA hoạt động++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## Những gì bạn có thể bảo vệ++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## Showcase & Benchmark++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## Câu hỏi thường gặp (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## Tài liệu++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_zh-TW.md b/docs/readme/README_zh-TW.mdnew file mode 100644index 0000000..4729a27--- /dev/null+++ b/docs/readme/README_zh-TW.md@@ -0,0 +1,187 @@+<div align="center">++[English](../../README.md) · [简体中文](README_zh.md) · **繁體中文** · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)++# BLA: Blind LLM Agents++### 一個覆蓋二進位檔、桌面與前端應用、資料庫、AI 模型及執行期行為的反 AI 逆向工程 MCP 與 CLI 護盾。++**打造你的核心功能。從二進位底層致盲一切企圖複製它的 AI 代理。**++[](https://www.npmjs.com/package/bla-shield)+[](../cli-and-mcp.md)+[](#what-you-can-protect)+[](#showcases)+[](../../LICENSE)++[快速開始](#quick-start) · [BLA 運作原理](#how-bla-works) · [你可以保護哪些目標](#what-you-can-protect) · [實戰案例與基準測試](#showcases) · [常見問題 (FAQ)](#faq) · [文件](#documentation)++<code>npx bla-shield setup</code>++</div>++> [!IMPORTANT]+> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-shield npm package](https://www.npmjs.com/package/bla-shield).++<div align="center">++<br />++<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="1200" />++<br />++</div>++---++擔心別人用 [REA](https://github.com/morluto/rea) 或 AI 程式設計代理指向你發布的軟體,幾十秒內扒光並複製你的核心邏輯?直接讓你的 Agent 用 BLA(`Poison → Exhaust → Hallucinate`)為建置產物加上對抗護盾。它無需改寫原始碼即可掃描暴露面、植入架構級飛地迷霧與演算法算力沼澤(Tarpits),並驗證自動化逆向徹底失效。++BLA 將你的程式設計代理連接到原生二進位檔、JavaScript 與 Electron 應用、WebAssembly 模組、Python 位元組碼、SQLite 資料庫、AI 模型權重與行動端套件的保護工具。所有保護均在本地運行,100% 保持原有執行期行為不變。++<a id="quick-start"></a>++## 快速開始++### 設定你的 Agent++```bash+npx bla-shield setup+```++### 直接向你的 Agent 提問++- **1. Audit (`Pre-flight REA Audit`):**+ ```text+ Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ ```+- **2. Protect (`Poison + Exhaust + Hallucinate`):**+ ```text+ Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ ```+- **3. Verify (`Verify Defense & Token Burn`):**+ ```text+ Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ ```++### 使用終端機命令++```bash+# 1. Audit exposure+npx -y bla-shield@latest audit /absolute/path/to/app --json++# 2. Protect artifact+npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt++# 3. Verify Counter-REA resistance+npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app++# 4. Run 8-target Counter-REA benchmark+npx -y bla-shield@latest benchmark++# 5. Emit compile-time C/C++, Rust, or Go defense headers+npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h++# Install globally+npm install --global bla-shield+bla --help+```++### 在打包工具中使用++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### 更新 BLA++```bash+bla update+npx bla-shield@latest setup+```++<a id="how-bla-works"></a>++## BLA 運作原理++1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.+2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `morluto/rea`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.+3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.++<a id="what-you-can-protect"></a>++## 你可以保護哪些目標++| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |+| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |+| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |+| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |+| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |+| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |+| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |+| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |++<a id="showcases"></a>++## 實戰案例與基準測試++| Showcase Target | Before BLA (REA Alone) | After `npx bla-shield protect` | Token Burn | Runtime Check |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |+| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |+| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |+| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |+| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |+| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |++<a id="faq"></a>++## 常見問題 (FAQ)++<details>+<summary><strong>Which agents can use BLA?</strong></summary>++Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-shield setup`.++</details>++<details>+<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>++No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.++</details>++<details>+<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>++No. All 19 format shields are built directly into `bla-shield` with zero external dependencies.++</details>++<details>+<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>++Never. All operations run 100% locally on your machine.++</details>++<a id="documentation"></a>++## 文件++- [Installation and agent setup](../installation.md)+- [CLI and MCP contracts](../cli-and-mcp.md)+- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)diff --git a/docs/readme/README_zh.md b/docs/readme/README_zh.mdindex bb9f4ee..c88c088 100644--- a/docs/readme/README_zh.md+++ b/docs/readme/README_zh.md@@ -1,70 +1,279 @@<div align="center">-[English](../../README.md) · **简体中文**+[English](../../README.md) · **简体中文** · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)-<img src="../assets/bla-hero-banner.svg" alt="BLA: Blind LLM Agents — Poison -> Exhaust -> Hallucinate" width="100%" />+# BLA: Blind LLM Agents-# BLA: Blind LLM Agents (`bla-shield`)+### 一个覆盖二进制、桌面与前端应用、数据库、AI 模型及运行时行为的反 AI 逆向工程 MCP 与 CLI 护盾。-### 一个专为对抗 REA(Reverse Engineer Anything)及 AI 逆向工程代理而生的 CLI 与 MCP 防御护盾。--**软件时代没有终结,它只是学会了反击。**+**构建你的核心功能。从二进制底层致盲一切企图克隆它的 AI 代理。**[](https://www.npmjs.com/package/bla-shield)-[](../../README.md#mcp-server--coding-agent-integration)-[](../../README.md#empirical-verification-against-morlutorea)-[](../../LICENSE)+[](../cli-and-mcp.md)+[](#你可以保护哪些目标)+[](#实战案例与基准测试)+[](../../LICENSE)++[快速开始](#快速开始) · [BLA 工作原理](#bla-工作原理) · [你可以保护哪些目标](#你可以保护哪些目标) · [实战案例与基准测试](#实战案例与基准测试) · [常见问题 (FAQ)](#常见问题-faq) · [文档](#文档)-<code>npx bla-shield setup</code> · <code>npx bla-shield audit ./dist</code> · <code>npx bla-shield protect ./dist</code>+<code>npx bla-shield setup</code></div>----+> [!IMPORTANT]+> 请从官方仓库 [qybaihe/bla](https://github.com/qybaihe/bla) 或 npm 包 [bla-shield](https://www.npmjs.com/package/bla-shield) 获取 BLA。-当 [REA (Reverse Engineer Anything)](https://github.com/morluto/rea) 让 AI 编程代理拥有了一键反编译、AST/IPC 自动追踪与取证账本(`Decompile → Understand → Recreate`)时,传统的变量改名混淆(把 `calculatePrice` 改成 `a_1`)在 LLM 面前瞬间失效——因为大模型最擅长的就是通过上下文语义把变量含义猜出来。+<div align="center">++<br />-**BLA (`Blind LLM Agents` / `Block Anything`)** 是专为正面硬刚 AI 逆向工程代理而设计的开源对抗性护盾:+<img src="../assets/bla-vs-rea-showcase.svg" alt="左右分屏对比:未受保护应用被 REA 在 38 秒内复刻 vs. BLA 护盾触发 2,121 倍 Token 消耗与容量上限熔断" width="1200" />-> **REA 的三步口号:** `Decompile(反编译) → Understand(理解) → Recreate(复刻)`-> **BLA 的三步反制:** `Poison(架构投毒) → Exhaust(榨干算力) → Hallucinate(制造幻觉)`-> ***Make Reverse Engineering Bankrupt Again(让逆向工程再次破产)。***+<br />++</div>----## 左右分屏实战对比:Before BLA vs. After `npx bla-shield protect`+担心别人用 [REA](https://github.com/morluto/rea) 或 AI 编程代理指向你发布的软件,几十秒内扒光并复刻你的核心逻辑?直接让你的 Agent 用 BLA(`Poison → Exhaust → Hallucinate`)为构建产物加上对抗护盾。它无需重写源码即可扫描暴露面、展示攻击者能提取的证据、植入架构级飞地投毒与算法算力沼泽(Tarpits),并验证自动化逆向复刻彻底失效。-<div align="center">- <img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-shield protect" width="100%" />-</div>+BLA 将你的编程代理连接到原生二进制、JavaScript 与 Electron 应用、WebAssembly 模块、Python 字节码、SQLite 数据库、AI 模型权重与移动端包体的保护工具。你也可以在终端或打包工具(Vite / Webpack / Rollup / esbuild)中直接调用。所有保护均在本地运行,100% 保持原有运行时功能与返回值不变。-### 四大核心反制杀手锏(100% 覆盖 REA 静态、动态与垂直逆向面)+`setup` 会自动向你的 Agent 注册 BLA 的 MCP 服务并安装配套技能说明。所有静态、字节码与二进制护盾全部内置,无需安装任何第三方商业加壳器或外部编译器。-1. **💥 REA 语义与容器容量上限精准爆破(Zero Runtime Overhead):**- 针对 `morluto/rea` 内部源码的静态与语义分析器阈值(JS `primitive-candidates > 256`、`alias-selections > 512`、`getter-expansion > 512`、`primitive-bytes > 1 MiB`;Rust `maximum_rustc_hashes > 64`;Electron Fuses `maximumSentinelsPerSlice > 32`;Flutter/Dart `MAX_SNAPSHOT_HASH_CANDIDATES > 64`;Safetensors/GGUF `MODEL_JSON_NESTING > 32`;SQLite `SqliteColumnEvaluationFailure` 虚拟生成列陷阱),植入运行时零开销的防御结构,直接将 REA 的分析状态击穿降级为 `partial` / `limited` 或直接触发容量熔断!-2. **🕸️ Token 粉碎机 / 算法算力沼泽(Algorithmic Tarpits):**- 自动在核心业务函数周围编织 14–36 个高逼真度、互相层层交叉引用(Fake XRefs)的诱饵状态机。当攻击者使用 REA 的 `trace_application_feature` 或 `build_reconstruction_obligation_ledger` 时,取证图节点暴增 **15x–50x**,诱导 AI Agent 陷入死胡同疯狂调用 MCP 工具查证,将单次逆向的 Token 账单放大 **2,000 倍以上**!-3. **🎭 飞地托管幻觉与蜜罐资产(Enclave Chaff, Honey SourceMaps & Honey SQLite Tables):**- 在 AST 不可达分支、Electron IPC 通道、WASM `"name"` 自定义段、CPython `.pyc` 常量池、原生二进制 `.rodata` 段、SQLite3 蜜罐表以及 Android DEX 类定义表中植入安全的**硬件飞地托管声明(TEE/SGX Enclave Delegation Mirage)**与 **VLQ v3 蜜罐 SourceMap**,误导逆向大模型得出“核心逻辑托管于硬件 Enclave,当前文件仅为兼容层空壳”的结论。-4. **🛡️ “楚门的世界”动态 CDP / Frida 运行时反制护盾(Truman Show Runtime Shield):**- 自动检测 `inspector.url()`、`--inspect`、CDP 调试会话与 Frida/WebDriver 探针;并将 Electron 二进制中的 Fuse 位原地加固(关闭 `RunAsNode` 与 `EnableNodeCliInspectArguments`),向动态调试探针返回合成飞地遥测数据,同时保证正常用户 100% 原生运行体验。+## 快速开始----+### 配置你的 Agent++安装 Node.js 与 npm 后,运行:++```bash+npx bla-shield setup+```++选择你使用的编程代理(或加上 `--all-detected --yes`),预览变更并确认。`setup` 会自动注册 BLA 的 MCP 服务器并安装 `blind-llm-agents` 技能,同时自动备份原有配置文件。完成后重启你的 Agent 即可。++支持 Claude Code、Codex、Cursor、Gemini CLI、Windsurf、Google Antigravity、OpenCode、VS Code 与 GitHub Copilot CLI。手动配置方式参见[安装与配置指南](../installation.md)。++### 直接向你的 Agent 提问(各环节对应指令)++你可以直接用自然语言让 Agent 执行任意环节:++- **1. 发布前暴露面自检(`Audit`):**+ ```text+ 用 BLA 扫描 ./dist 目录,检查哪些模块和 Electron IPC 通道在 REA 面前处于裸奔状态,并估算 Claude 逆向克隆它的时间和成本。+ ```+- **2. 一键注入对抗护盾(`Protect`):**+ ```text+ 用 BLA 的 bankrupt 强度保护 ./dist/app.asar,注入飞地架构迷雾和算法算力沼泽,输出到 ./dist/app.shielded.asar。+ ```+- **3. 验证防线有效性与 Token 放大倍率(`Verify`):**+ ```text+ 对比验证 ./dist/app.shielded.asar 和原文件 ./dist/app.asar,确认 REA 分析状态已被降级为 limited,并汇报 Token 消耗放大倍数。+ ```++### 使用终端命令(各环节对应 CLI 语句)++所有工作流均可通过 `npx bla-shield`(或全局安装后的 `bla`)在终端直接运行:++- **1. 扫描目标暴露度(`audit`)** —— 查看暴露评分(`0–100`)、裸露符号与攻击者克隆成本:+ ```bash+ npx -y bla-shield@latest audit /absolute/path/to/app --json+ ```+- **2. 注入对抗护盾(`protect`)** —— 植入语义预算爆破器、Tarpit 状态机、飞地诱饵与动态反调试护盾:+ ```bash+ npx -y bla-shield@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt+ ```+- **3. 验证抗 REA 防线(`verify`)** —— 检验 REA 静态/语义分析器是否被限流降级且达到 >10x Token 放大:+ ```bash+ npx -y bla-shield@latest verify /absolute/path/to/app.shielded /absolute/path/to/app+ ```+- **4. 运行 8 大靶场基准测试(`benchmark`)**:+ ```bash+ npx -y bla-shield@latest benchmark+ ```+- **5. 生成 C/C++、Rust 或 Go 编译期防御头文件(`emit-headers`)**:+ ```bash+ npx -y bla-shield@latest emit-headers --lang c -o ./include/bla_shield.h+ ```-## 快速上手+如需全局安装 `bla` 命令以便日常随时调用:```bash-# 1. 发布前自检(模拟 REA 扫描暴露面与克隆成本)-npx bla-shield audit ./examples/dx-ball-sound-pan/sound-pan.js+npm install --global bla-shield+bla --help+```++### 在构建打包工具中使用(Vite / Rollup / Webpack / esbuild)++导入 `bla-shield/bundler`,在生产构建阶段自动保护生成的 JS 分包、注入蜜罐 SourceMap 并加固 `.wasm` 资产:++```typescript+import { defineConfig } from "vite";+import { blaVitePlugin } from "bla-shield/bundler";++export default defineConfig({+ plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],+});+```++### 更新 BLA++如果通过 `npm install --global` 或 `bun add --global` 安装:++```bash+bla update+```++`bla --update` 为等效别名。如果使用 `npx`,可通过以下命令刷新 Agent 注册与技能:++```bash+npx bla-shield@latest setup+```++## BLA 工作原理++你的 Agent 通过 MCP 调用 BLA 来审计构建产物、注入针对特定格式的反 REA 护盾并验证加固结果。当攻击者的 Agent 随后使用 REA 逆向受保护的产物时,REA 会触发确定性的内部容量熔断、陷入虚假交叉引用迷宫,并将核心业务逻辑误判为硬件飞地空壳:++1. **Poison(架构投毒与蜜罐资产):** 在不可达分支与常量池中植入硬件飞地托管清单(`SGX` / `TPM2` / `Secure Enclave`)、VLQ v3 **蜜罐 SourceMap**(`enclave://tee-runtime/`)、WASM `"name"` 蜜罐段以及 SQLite 蜜罐表。+2. **Exhaust(语义预算爆破与算法算力沼泽):** 以零运行时开销精准击穿 `morluto/rea` 硬编码阈值(`primitive-candidates > 256`、`alias-selections > 512`、`getter-expansion > 512`、`primitive-bytes > 1 MiB`、`maximum_rustc_hashes > 64`、`maximumSentinelsPerSlice > 32`),并在调用图中编织 14–36 个互相引用的 Fake XRef 状态机。+3. **Hallucinate(动态反 CDP 欺骗与 Fuse 加固):** 原地加固 Electron V1 Fuse 字节串(`RunAsNode=0`、`EnableNodeCliInspectArguments=0`),并植入“楚门的世界”运行时守卫——一旦检测到 CDP、Node Inspector、Frida 或 WebDriver 探针挂载,立即返回合成的飞地遥测数据。++## 你可以保护哪些目标++BLA 仅需 Node.js 22.5+(或 24.x+)与 npm,所有格式护盾完全内置,无需任何外部二进制依赖:++| 保护目标 | BLA 注入内容与 REA 失效方式 | 对应命令与说明 |+| ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |+| JavaScript / TypeScript | 击穿 `primitive-candidates > 256`、`alias-selections > 512`、`getter-expansion > 512` + 36 个状态机 | `bla protect app.js` · 内置 Babel AST 引擎;参见[反制矩阵](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md) |+| Electron `.asar` 应用 | IPC 通道去字面量化(`channel: null`)、注册同名冲突诱饵 IPC 处理器与影子飞地模块 | `bla protect app.asar` · 内置 Chromium Pickle `.asar` 解包与 SHA-256 完整性重打包器 |+| Electron 二进制 Fuses | 原地加固真实 V1 Fuse 位(关闭 `RunAsNode` 与 `Inspect`)+ 注入 `34 > 32` 个诱饵 Fuse 哨兵 | `bla protect ElectronApp` · 直接触发 `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| 动态运行时 CDP / Frida | 检测 `inspector.url()`、`--inspect`、`__frida` 并向动态探针返回合成飞地遥测包 | 自动注入到受保护的 JS/TS/Electron 产物中([`runtime-shield.ts`](../../src/shields/runtime/runtime-shield.ts)) |+| SourceMap 与 HTML | 剥离真实映射,生成合法的 VLQ v3 蜜罐 SourceMap(指向 `enclave://tee-runtime/...`) | `bla protect index.html` · 误导 REA 的 `recover_javascript_sources` 与 `trace_web_source_location` |+| 原生二进制文件 | 追加 `.bla.rodata` 飞地声明、诱饵符号表与多重扫描器溢出陷阱 | `bla protect daemon.elf` · 内置 ELF64、Mach-O(Thin & Universal)与 Windows PE/COFF 护盾 |+| Rust 二进制 | 注入 `68 > 64` 个不同的 `/rustc/<40-hex>/` 路径 + 诱饵 zlib `.dep-v0` 依赖图 | `bla protect rust-bin` · 触发 `RustBinaryProvider`(`MAX_RUSTC_HASHES = 64` 容量熔断) |+| Go 二进制 | 注入诱饵 Go `go1.23.4` 构建信息与 `dep\tgithub.com/enclave-tees/sgx-bridge` 模块记录 | `bla protect go-bin` · 污染 REA `inspect_go_binary` 模块清单 |+| Flutter / Dart AOT | 注入 `66 > 64` 个 Dart 快照魔数头(`0xf5f5dcdc`)+ `6 > 4` 行 LLVM 工具链标识 | `bla protect libapp.so` · 触发 `SnapshotHashScanner (capped: true)` 与版本冲突告警 |+| WASM 模块 | 剥离调试段,注入蜜罐 `"name"` 自定义段(`tee_hardware_enclave_stub`)与飞地清单段 | `bla protect core.wasm` · 内置 LEB128 解析器,100% 通过 `WebAssembly.validate` |+| Python 与 `.pyc` 字节码 | 向 `.py` 注入算法沼泽状态机,向 `.pyc` 常量池追加 `TYPE_ASCII` 飞地声明 | `bla protect module.pyc` · 支持 CPython 3.7–3.14 `.pyc` 头部与 marshal 结构 |+| SQLite 数据库 | 注入 3 张飞地蜜罐表与 `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` 虚拟列陷阱 | `bla protect data.sqlite` · 真实业务表 100% 正常查询;REA 预览时触发 `SqliteColumnEvaluationFailure` |+| AI 模型权重文件 | 向 `.safetensors` 与 `.gguf` 头部植入 `35 > 32` 层深度嵌套的 JSON / ARRAY 结构 | `bla protect weights.safetensors` · 触发 `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX 与 APK | 向 `classes.dex` 注入 `Lcom/enclave/sgx/...` 诱饵类并自动重算 SHA-1 与 Adler32 校验和 | `bla protect classes.dex` 或 `app.apk` · 符合 Dalvik/ART 校验规范,污染 JADX/JEB 类树 |+| Unity IL2CPP 元数据 | 向 `global-metadata.dat`(`0xFAB11BAF`)追加飞地桥接元数据与方法拓扑沼泽 | `bla protect global-metadata.dat` · 污染 REA `inspect_il2cpp_metadata` 符号恢复 |+| C / C++ / Rust / Go 源码| 生成带 `used, noinline` 诱饵状态机的编译期头文件 `bla_shield.h` / `.rs` / `.go` | `bla emit-headers --lang c\|rust\|go` · 直接编译进二进制,污染 Ghidra / Hopper / IDA 反编译视图 |-# 2. 一键注入对抗护盾(支持 JS/TS、Electron .asar、WASM、Python .py/.pyc、ELF/Mach-O/PE、SQLite3、Safetensors/GGUF、DEX/IL2CPP、ZIP/APK)-npx bla-shield protect ./examples/dx-ball-sound-pan/sound-pan.js -o ./sound-pan.shielded.js --intensity bankrupt+## 实战案例与基准测试-# 3. 验证防线有效性与 Token 放大倍率-npx bla-shield verify ./sound-pan.shielded.js ./examples/dx-ball-sound-pan/sound-pan.js+运行 `npx bla-shield benchmark` 即可在本地执行全部 8 个对标靶场,实测验证 REA 失效模式与 100% 运行时等价性:-# 4. 运行 8 大靶场全维度对比基准测试(对标 REA 官方 DX-Ball、Notion、SQLite、AI 模型与原生二进制案例)-npx bla-shield benchmark+| 对标靶场(复刻自 REA 官方成名案例与核心能力) | 防御前(REA 裸奔状态) | `npx bla-shield protect` 防御后 | Token 消耗放大 | 运行时等价校验 |+| :--- | :--- | :--- | :---: | :---: |+| **1. DX-Ball 声道平移计算** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% 一致 |+| **2. Notion Electron 剪贴板桥** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% 一致 |+| **3. 企业级离线授权校验核心** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% 一致 |+| **4. WebAssembly 密码学内核** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% 一致 |+| **5. Native ELF64 二进制** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% 一致 |+| **6. 本地 SQLite 授权数据库** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% 一致 |+| **7. 端侧 AI 权重模型** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% 一致 |+| **8. Android Dalvik 字节码** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% 一致 |-# 5. 一键配置 Claude Code / Cursor / Codex / Antigravity 等 Agent 的 MCP 与 Skill-npx bla-shield setup --all-detected --yes+### DX-Ball:让声道算法逆向彻底破产++REA 官方首推案例可在几十秒内(`$0.20`)还原 DX-Ball 的 `clampPan` 与 `calculateSoundPanFromX`。运行 `npx bla-shield protect examples/dx-ball-sound-pan/sound-pan.js --intensity bankrupt` 后,REA 的 `parse_status` 跌落至 `"partial"`,`examination.status` 降级为 `"limited"`(触发 `alias-selections`、`primitive-bytes`、`primitive-candidates` 三重熔断),取证账本从 2 个函数暴增至 38 个互锁状态机(Token 消耗放大 **2,121.3 倍**),而所有输入坐标的计算返回值与原版 100% 精确一致。++### Notion:致盲 Electron 剪贴板 IPC 桥接追踪++REA 通过精确匹配 `ipcRenderer.invoke` 与 `ipcMain.handle` 的唯一字面量字符串来追踪 Electron 应用。BLA 将真实 IPC 通道拆解为 $\ge 9$ 段数论不透明条件表达式(使 `electron.ipc[0].channel === null`),同时在相同字面量通道上注册多个诱饵处理器,强制触发 `electron_call_paths_limited: true`。++### 原生二进制、SQLite 与 AI 模型:直接触发 REA 容器容量熔断++当攻击者对受 BLA 保护的产物执行 `inspect_rust_binary`、`inspect_electron_fuses`、`inspect_sqlite_database` 或 `inspect_model_artifact` 时,REA 解析器会确定性地触发容量与求值异常并直接中止(`Read-only data contains more than 64 distinct rustc commit paths`、`Slice 0 contains more than 32 Electron fuse sentinels`、`SqliteColumnEvaluationFailure`、`ModelFormatFailure: json-nesting`)。++## 常见问题 (FAQ)++<details>+<summary><strong>哪些编程代理(Agents)可以使用 BLA?</strong></summary>++任何支持本地 MCP 服务器或 `SKILL.md` 的 AI 编程代理均可使用。`npx bla-shield setup` 支持一键自动配置 Claude Code、Cursor、Codex、Gemini CLI、Windsurf、Google Antigravity、OpenCode、VS Code 与 GitHub Copilot CLI。详见[安装指南](../installation.md)。++</details>++<details>+<summary><strong>BLA 会拖慢我的软件运行速度或改变原有的运行结果吗?</strong></summary>++不会。BLA 注入的语义预算爆破器(`alias-selections`、`getter-expansion`、`primitive-bytes`)与 Tarpit 诱饵调用图均受 $O(1)$ 数论不透明谓词($7x^2 - 1 \neq y^2 \pmod 7$)保护,在真实运行时永远不会进入死胡同分支。所有 8 个基准测试靶场均通过了 100% 输入/输出等价性校验。++</details>++<details>+<summary><strong>BLA 与传统混淆器(如 javascript-obfuscator 或 O-LLVM)有什么本质区别?</strong></summary>++传统混淆器依赖变量改名(把 `calculatePrice` 改成 `_0x1a2b`),而大语言模型最擅长的就是通过上下文控制流把变量语义猜出来;重度虚拟化壳则会严重拖慢性能。BLA 专门针对 **AI 编程代理与 `morluto/rea` 的静态/语义分析器**设计——直接击穿 REA 内部的硬编码资源上限、破坏 IPC 字面量配对、用硬件飞地托管声明污染 SourceMap 与元数据,并将 Agent 的 MCP Token 账单放大最高 2,500 倍以上。++</details>++<details>+<summary><strong>我需要安装 Hopper、Ghidra、IDA 或 WABT 才能保护我的文件吗?</strong></summary>++完全不需要。BLA 的全部 19 种格式护盾(Babel AST、Chromium `.asar`、LEB128 `.wasm`、CPython `.pyc`、ELF/Mach-O/PE、SQLite3、`.safetensors`/`.gguf`、`.dex`/`Il2Cpp`)均 100% 内置在 `bla-shield` 中,零外部工具依赖。++</details>++<details>+<summary><strong>当别人用 REA 逆向被 BLA 保护的软件时会发生什么?</strong></summary>++1. REA 的 JavaScript/Electron 分析器从 `complete` 降级为 `partial` / `limited`,且无法配对任何 IPC 通道(`channel: null`)。+2. REA 的 Rust 二进制、Electron Fuse、SQLite 和 AI 模型检查器直接触发硬编码容量熔断并报错退出。+3. 若攻击者让 Agent 继续执行 `trace_application_feature` 追踪特征,Agent 会陷入 14–36 个互锁的 Fake XRef 状态机与蜜罐 SourceMap(`enclave://tee-runtime/`)中,迅速耗尽上下文窗口与 API 额度。++</details>++<details>+<summary><strong>安装 Skill 有什么作用?</strong></summary>++[`blind-llm-agents` 技能](../../.agents/skills/blind-llm-agents/SKILL.md)为你的编程代理提供了完整的反逆向防御工作流说明,指导 Agent 自动完成发布前暴露面审计、选择保护强度(`stealth`、`balanced`、`maximum`、`bankrupt`)、接入打包插件以及验证防线指标。++</details>++<details>+<summary><strong>BLA 会上传我的源码或二进制文件吗?</strong></summary>++绝不上传。BLA 的所有审计、加固与验证均 100% 在本地机器离线完成,支持确定性随机种子(`--seed`),没有任何网络请求。++</details>++<details>+<summary><strong>遇到问题或 Bug 怎么办?</strong></summary>++请先更新至最新版本并运行 `bla doctor` 检查各防护引擎状态:++```bash+npx bla-shield@latest doctor+npx bla-shield@latest setup```++若问题仍存在,请在 [GitHub Issues](https://github.com/qybaihe/bla/issues) 提交你的 BLA 版本号(`bla --version`)、目标格式与复现步骤。++</details>++## 文档++- [安装与 Agent 配置](../installation.md):Agent 自动注册、Bundler 插件集成、更新与卸载。+- [CLI 与 MCP 契约说明](../cli-and-mcp.md):命令行参数、退出码与 JSON-RPC 2.0 MCP 工具定义。+- [反制 REA 技术矩阵](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md):`morluto/rea` 内部源码阈值与 BLA 的逐项击穿原理。++安全问题请通过 [SECURITY.md](../../SECURITY.md) 反馈。++## 免责声明++详见 [DISCLAIMER.md](../../DISCLAIMER.md)。++BLA 是一款防御性软件保护工具,仅用于加固你拥有合法权利或获授权保护的软件、前端产物、模型与二进制文件。所有注入的诱饵载荷均为良性架构元数据与合成状态机函数,100% 保持原程序的正常运行时行为。++## 贡献指南++欢迎在 [qybaihe/bla](https://github.com/qybaihe/bla) 提交 Issue 或 Pull Request。提交代码前请运行 `npm run build && npm test && node dist/cli.js benchmark`。++## 开源协议++[MIT](../../LICENSE)diff --git a/src/cli.ts b/src/cli.tsindex 76221cd..d2e4cf5 100644--- a/src/cli.ts+++ b/src/cli.ts@@ -40,6 +40,7 @@ Commands:benchmark Run the 8-target Counter-REA Showcase Benchmark suiteemit-headers Generate compile-time C/C++, Rust, or Go defense headersdoctor Check readiness of BLA engines & agent registrations+ update Update global bla-shield installation & print setup refresh instructionsuninstall Remove BLA MCP configuration & skill filesmcp Start the BLA Model Context Protocol (MCP) server over stdio@@ -114,6 +115,8 @@ export function parseCliArgs(argv: readonly string[]): ParsedCliArgs {honeyMaps = false;} else if (arg === "--mcp") {command = "mcp";+ } else if (arg === "--update") {+ command = "update";} else if ((arg === "-o" || arg === "--output") && i + 1 < argv.length) {output = argv[++i]!;} else if (arg === "--intensity" && i + 1 < argv.length) {@@ -194,6 +197,21 @@ export async function runCli(argv: readonly string[] = process.argv.slice(2)): Preturn 0;}+ case "update": {+ const updateInfo = {+ currentVersion: BLA_IDENTITY.version,+ package: BLA_IDENTITY.packageName,+ refreshSetupCommand: "npx bla-shield@latest setup",+ globalUpdateCommand: "npm install --global bla-shield@latest",+ };+ if (parsed.json) {+ console.log(JSON.stringify(updateInfo, null, 2));+ } else {+ console.log(`${formatBanner()}\n\nBLA v${BLA_IDENTITY.version} update workflow:\n • Global CLI update: npm install --global bla-shield@latest\n • Agent MCP refresh: npx bla-shield@latest setup\n`);+ }+ return 0;+ }+case "uninstall": {const res = runUninstall();if (parsed.json) console.log(JSON.stringify(res, null, 2));