From 0edd5f8debe4adcd40dfa5841f734847dcc45281 Mon Sep 17 00:00:00 2001 From: qybaihe Date: Mon, 2 Nov 2026 21:39:38 +0800 Subject: [PATCH] docs: sync STATE/skill/CHANGELOG for wasmPreserveExports and #40 progress Bump blind-llm-agents skill to 1.3.2; mark landed #40 items in STATE and weave-decoy follow-ups. --- .agents/skills/blind-llm-agents/SKILL.md | 11 ++++++++++- CHANGELOG.md | 1 + STATE.md | 7 ++++--- docs/cli-and-mcp.md | 1 + docs/counter-rea-deception.md | 2 +- docs/one-click-agent-defense.md | 5 +++++ docs/weave-decoy-mcp.md | 5 +++-- 7 files changed, 25 insertions(+), 7 deletions(-) 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 ` 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 ` 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 与更广的模板数值卫生仍开 ## 相关文档