Skip to content

armgit / bla

Public Imported from GitHub
0

🛡️ 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.

docs: sync STATE/skill/CHANGELOG for wasmPreserveExports and #40 progress

qybaihe0edd5f8debe4
diff --git a/.agents/skills/blind-llm-agents/SKILL.md b/.agents/skills/blind-llm-agents/SKILL.md
index c1aca30..b5775f7 100644
--- a/.agents/skills/blind-llm-agents/SKILL.md
+++ b/.agents/skills/blind-llm-agents/SKILL.md
@@ -7,7 +7,7 @@ description: >
Agents). Prefer this skill as the guide; call existing MCP tools / CLI — do not invent
new MCP tools. Default verb: bla_harden. Refuse crack/RE of third-party software.
metadata:
- version: "1.3.1"
+ version: "1.3.2"
---
# BLA: Blind LLM Agents
@@ -92,6 +92,15 @@ targets (or says self-seal / 自密封):
Off by default. Browser builds soft-skip (digest=0). Pair with weave decoys when
Python structural weave is also desired.
+## WASM public ABI preserve (#40.3)
+
+When hardening `.wasm` at maximum/bankrupt and the customer must keep specific export names:
+
+1. CLI: `--wasm-preserve-exports main,add`
+2. MCP: `wasm_preserve_exports: ["main","add"]`
+3. Config: `"wasmPreserveExports": ["main","add"]` in `.blarc`
+Internal-looking names (`__*`, `debug_*`, …) may still be renamed; update glue via the rename map when needed.
+
## Lane-independence footgun lint (#40.1)
Before shipping a custom license/activation gate, run:
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8de6b0d..2efdc42 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Added
- **Self-seal (#40.5):** opt-in CLI `--self-seal` / MCP `self_seal` / `.blarc selfSeal` injects Node sibling-module + env-fingerprint integrity binding into JS AST shield and entangles the opaque-predicate seed.
+- **WASM preserve ABI (#40.3):** `.blarc`/`CLI`/`MCP` `wasmPreserveExports` / `--wasm-preserve-exports` / `wasm_preserve_exports` keeps listed export names when rename runs.
- **WASM export rename (#40.3):** `protectWasmBinary` renames internal-looking exports at maximum/bankrupt (preserve public ABI via `preserveExports`); returns `exportsRenamed`.
- **Lane-independence lint (#40.1):** `bla lint-lanes <file>` heuristic warn for per-lane oracle footguns; `lintLaneIndependence()` API.
- **Sidecar entanglement DESIGN + planner stub:** `docs/design/sidecar-entry-entanglement.md` + `planSidecarEntanglement()`.
diff --git a/STATE.md b/STATE.md
index 3296d72..0bd86b3 100644
--- a/STATE.md
+++ b/STATE.md
@@ -89,13 +89,14 @@ Outside the repo, `npm pack` → install tarball → isolated `HOME`:
## Nightly roadmap remaining
-1. **Self-seal / defenseScore honesty (#40)** — opt-in self-integrity + honest scores for onefile/peel limits.
-2. **Sidecar entry entanglement** — entangle protectors with entry/sidecar so stripping decoys breaks runtime.
-3. **Deception shields → more formats** — WASM custom sections/export names, DEX string pool, SQLite comments/metadata, Safetensors/GGUF header metadata.
+1. ~~**Self-seal / defenseScore honesty (#40)**~~ — landed soft-caps + opt-in `--self-seal` / MCP `self_seal` / `.blarc selfSeal` (batch 2026-11-02). Remaining: deeper onefile/peel score model.
+2. **Sidecar entry entanglement** — DESIGN + `planSidecarEntanglement()` stub landed; full strip⇒fail rewrite still open.
+3. **Deception shields → more formats** — WASM export rename + `wasmPreserveExports` landed; DEX/SQLite/model densify and broader numeric template hygiene still open.
4. **Empirical JADX / Android red-team** — real REA mapping+JNI vs BLA-hardened unsigned APK.
5. **ESP flash / esp-image (#8228)** — if REA moved there; UF2 empirical red-team otherwise.
6. **Dependabot majors #29–#35** — still held pending review.
7. Polish doctor subsystem list (SQLite / models / BEAM / EVM / Android R8) for parity with shields.
+8. **Lane-independence lint (#40.1)** — `bla lint-lanes` heuristic shipped; optional CI gate / doctor hook TBD.
## Publish checklist (once a GitHub token exists)
diff --git a/docs/cli-and-mcp.md b/docs/cli-and-mcp.md
index fc08de8..34ea42e 100644
--- a/docs/cli-and-mcp.md
+++ b/docs/cli-and-mcp.md
@@ -35,6 +35,7 @@ For coding agents, the **[`blind-llm-agents` skill](../.agents/skills/blind-llm-
Project config parity: set `"weaveDecoys": true` in `.blarc` / `bla.config.json` (schema `bla.config.v1.json`) to enable the same flag without repeating `--weave-decoys` / MCP `weave_decoys` on every invoke. CLI/MCP flags still OR with the config value.
Opt-in **self-seal** (issue #40.5): CLI `--self-seal`, MCP `self_seal`, `.blarc` `"selfSeal": true`. Injects a Node self-integrity preamble (module + optional sibling paths + env fingerprint) and folds the digest into the opaque-predicate seed for JS/Node targets.
+WASM public ABI preserve list (issue #40.3): CLI `--wasm-preserve-exports a,b`, MCP `wasm_preserve_exports`, `.blarc` `"wasmPreserveExports": ["a","b"]`. Kept names stay; internal-looking exports may still rename at maximum/bankrupt.
Heuristic **lane-independence lint** (issue #40.1): `bla lint-lanes <file>` warns when gate code looks like independent per-lane checks. Defensive guidance only — prefer whole-key chained mixing.
diff --git a/docs/counter-rea-deception.md b/docs/counter-rea-deception.md
index 281df2b..43a357a 100644
--- a/docs/counter-rea-deception.md
+++ b/docs/counter-rea-deception.md
@@ -41,4 +41,4 @@ resource `bla://directives/weave-decoy`, tool `bla_weave_plan`, flag
## WASM export rename (#40.3)
-`protectWasmBinary` can rename non-public / internal-looking exports while preserving names listed in `preserveExports`. At `maximum`/`bankrupt`, internal-looking names (`__*`, `debug_*`, …) are renamed by default. Forced full rename: `renameNonPublicExports: true` with an explicit preserve list for the public ABI. Returns `exportsRenamed` for glue updates.
+`protectWasmBinary` can rename non-public / internal-looking exports while preserving names listed in `preserveExports`. At `maximum`/`bankrupt`, internal-looking names (`__*`, `debug_*`, …) are renamed by default. Forced full rename: `renameNonPublicExports: true` with an explicit preserve list for the public ABI. Returns `exportsRenamed` for glue updates. Project / CLI / MCP parity: `.blarc` `wasmPreserveExports`, `--wasm-preserve-exports`, MCP `wasm_preserve_exports`.
diff --git a/docs/one-click-agent-defense.md b/docs/one-click-agent-defense.md
index 6de9575..a12e282 100644
--- a/docs/one-click-agent-defense.md
+++ b/docs/one-click-agent-defense.md
@@ -73,3 +73,8 @@ See [`weave-decoy-mcp.md`](./weave-decoy-mcp.md). Do **not** add dismissible
## Opt-in self-seal (#40.5)
Pass `--self-seal` / MCP `self_seal: true` / `.blarc` `"selfSeal": true` so JS/Node harden paths inject sibling-module integrity binding and entangle the opaque seed. Off by default.
+
+## WASM export rename / preserve (#40.3)
+
+At `maximum`/`bankrupt`, BLA may rename internal-looking WASM exports. Pass `--wasm-preserve-exports main,add` / MCP `wasm_preserve_exports` / `.blarc` `"wasmPreserveExports": ["main","add"]` so the public ABI stays stable while glue can consume the rename map for anything else.
+
diff --git a/docs/weave-decoy-mcp.md b/docs/weave-decoy-mcp.md
index fed0227..16eaf82 100644
--- a/docs/weave-decoy-mcp.md
+++ b/docs/weave-decoy-mcp.md
@@ -78,8 +78,9 @@
## 8. Follow-up
-- 更多 sidecar 格式的入口纠缠验收;可选 self-seal / defenseScore honesty (#40)
-- 可选 self-seal 与 `defenseScore` 对 onefile 诚实性(#40)
+- 更多 sidecar 格式的入口纠缠验收(DESIGN + planner stub 已落地;完整 strip⇒fail rewrite 仍开)
+- self-seal / defenseScore honesty soft-caps 已落地;onefile/peel 更深的分数模型仍开(#40)
+- `bla lint-lanes` / WASM `wasmPreserveExports` 已落地;格式 densify 与更广的模板数值卫生仍开
## 相关文档