mirror of
https://github.com/qybaihe/bla.git
synced 2026-11-20 08:20:59 +08:00
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.
This commit is contained in:
@@ -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:
|
||||
|
||||
@@ -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()`.
|
||||
|
||||
@@ -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)
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
@@ -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`.
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
@@ -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 与更广的模板数值卫生仍开
|
||||
|
||||
## 相关文档
|
||||
|
||||
|
||||
Reference in New Issue
Block a user