feat(harden): refuse lane-independent JS gates unless allowed

protect/defend/harden refuse JS/TS that looks lane-independent unless
allowLaneIndependentGates / --allow-lane-independent / allow_lane_independent.
CrackMe v6 teaching fixture now opts in explicitly (preserve mix/seal + allow
lanes). Skill v1.5.2 + docs: no silent stable WASM ABI; prefer whole-key mixing.
This commit is contained in:
qybaihe
2026-11-03 03:38:51 +08:00
parent fc1b2c18bd
commit 339415cc76
16 changed files with 177 additions and 12 deletions
+3 -1
View File
@@ -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.5.1"
version: "1.5.2"
---
# BLA: Blind LLM Agents
@@ -24,6 +24,8 @@ model misjudgment on proprietary logic, or **one-click / 一键加固** a build.
Defensive only: protect **their own** artifacts. Refuse crack, RE, bypass PoCs, or
attack playbooks against software they do not own.
**Principles (red-blue round-1):** do not ship a stable public WASM ABI without an explicit `wasm_preserve_exports` list; do not leave JS-side independent lane tables — prefer whole-key chained mixing (`bla_lint_lanes` / harden refuse).
## Prerequisites (once)
1. CLI: `npx bla-agents@latest setup`
@@ -25,3 +25,8 @@ Self-seal soft-skips in pure browser builds (digest stays 0). Pair with weave wh
## Electron notes
IPC ambiguity + route mirage layers activate on JS/TS/asar/directory targets during verify. Prefer defending the packaged `.asar` or the `dist/` that ships to users, not only sources.
## Lane-independence (gates / entitlement)
Do **not** keep independent per-byte / per-lane JS check tables (`Object.freeze(parseInt hex…)`, `charCodeAt(i)` → wasm mix/seal per lane). Prefer **whole-key chained mixing**. `bla_lint_lanes` returns severity **error**; harden/defend/protect **refuse** unless `allow_lane_independent` / `--allow-lane-independent` (teaching fixtures only).
@@ -4,7 +4,7 @@ Load this when hardening `.wasm` modules.
## Intensity & rename
At `maximum` / `bankrupt`, BLA may rename **internal-looking** exports (`__*`, `debug_*`, …). Public ABI names the customer must keep go in the preserve list:
At `maximum` / `bankrupt`, BLA renames **all** exports not listed in the preserve list (red-blue round-1: silent `mix`/`seal` ABI enabled preload hooks). Do **not** ship a stable public WASM ABI unless glue truly requires it — and then list names **explicitly**:
| Surface | How |
| :--- | :--- |
+4
View File
@@ -6,6 +6,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
### Changed
- **Red/Blue round-1 · Writeback P0 — WASM export rename default:** at `maximum`/`bankrupt`, `protectWasmBinary` renames **all** non-preserved exports (not only `__*` / `debug_*`). Keeping a stable public ABI requires explicit `wasmPreserveExports` / `--wasm-preserve-exports` / `wasm_preserve_exports`. Optional `renameInternalOnly: true` for the weaker pass.
- **Red/Blue round-1 · Writeback P0 — lane-independence is error + harden refuse:** `bla lint-lanes` / `bla_lint_lanes` findings are severity **error**; protect/defend/harden refuse JS/TS that looks lane-independent (including per-byte WASM mix/seal oracles) unless `allowLaneIndependentGates` / `--allow-lane-independent` / `allow_lane_independent`. Skill v1.5.2 principles: no silent stable WASM ABI; no JS independent lane tables; prefer whole-key mixing.
### Fixed
- **MCP/Skill 2.0 stabilization:** `bla_harden` dry-run no longer sets `overallSuccess: true`; CLI formatter labels dry-run as `DRY-RUN (nothing written)` instead of `SUCCESS`. Successful `bla_harden` writes now return `writeReceipt` (matching defend/protect and the stage A contract). `bla_redteam_report` on-disk reads use `status: available` (not `pass`) so agents cannot mistake a static fixture for a live REA verdict; harness stdout/stderr are clipped for MCP stdio safety. Skill guide **v1.5.1** documents available vs unverified.
+2 -2
View File
@@ -48,9 +48,9 @@ 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.
WASM public ABI preserve list (issue #40.3 / red-blue round-1): CLI `--wasm-preserve-exports a,b`, MCP `wasm_preserve_exports`, `.blarc` `"wasmPreserveExports": ["a","b"]`. At `maximum`/`bankrupt`, **every** non-listed export is renamed by default — keeping `mix`/`seal`-style names requires an explicit list.
Heuristic **lane-independence lint** (issue #40.1): CLI `bla lint-lanes <file>` and MCP `bla_lint_lanes` warn when gate code looks like independent per-lane checks. Defensive guidance only — prefer whole-key chained mixing.
Heuristic **lane-independence lint** (issue #40.1 / red-blue round-1): CLI `bla lint-lanes <file>` and MCP `bla_lint_lanes` emit severity **error** when gate code looks like independent per-lane checks. Harden/defend/protect **refuse** unless CLI `--allow-lane-independent` / MCP `allow_lane_independent` / `.blarc` `"allowLaneIndependentGates": true`. Prefer whole-key chained mixing.
### MCP Resources
+1 -1
View File
@@ -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. Project / CLI / MCP parity: `.blarc` `wasmPreserveExports`, `--wasm-preserve-exports`, MCP `wasm_preserve_exports`.
`protectWasmBinary` renames exports not listed in `preserveExports`. At `maximum`/`bankrupt`, **all** non-preserved names rename by default (red-blue round-1). Keeping a stable public ABI requires an explicit preserve list. Optional `renameInternalOnly: true` restores the weaker internal-only pass. Returns `exportsRenamed` for glue updates. Project / CLI / MCP parity: `.blarc` `wasmPreserveExports`, `--wasm-preserve-exports`, MCP `wasm_preserve_exports`.
+1 -1
View File
@@ -76,5 +76,5 @@ Pass `--self-seal` / MCP `self_seal: true` / `.blarc` `"selfSeal": true` so JS/N
## 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.
At `maximum`/`bankrupt`, BLA renames **all** non-preserved WASM exports. Pass `--wasm-preserve-exports main,add` / MCP `wasm_preserve_exports` / `.blarc` `"wasmPreserveExports": ["main","add"]` only when the public ABI must stay; otherwise consume the rename map. Do not leave independent JS lane tables — `bla lint-lanes` / harden refuse unless `--allow-lane-independent`.
+5
View File
@@ -154,6 +154,9 @@ export async function hardenChallenge({ key, flag, outDir, seed = SEED }) {
copyFileSync(join(SRC_DIR, "panel.html"), join(stage, "panel.html"));
copyFileSync(join(SRC_DIR, "core.wasm"), join(stage, "core.wasm"));
// Red/blue round-1: bankrupt renames all non-preserved WASM exports by default.
// This teaching fixture keeps mix/seal on purpose (explicit ABI) and opts into
// the lane-independent gate that bla_lint_lanes / harden now refuse by default.
const report = hardenProject({
directory: stage,
intensity: INTENSITY,
@@ -161,6 +164,8 @@ export async function hardenChallenge({ key, flag, outDir, seed = SEED }) {
llmDirectives: false,
emitManifest: false,
outputDirectory: hardened,
wasmPreserveExports: ["mix", "seal"],
allowLaneIndependentGates: true,
});
if (!report.overallSuccess) {
throw new Error(`hardenProject failed: ${JSON.stringify(report.artifacts?.map((a) => [a.relativePath, a.success, a.error]))}`);
+16 -1
View File
@@ -51,7 +51,7 @@ Commands:
defend <target> One-click full Counter-REA pipeline (inspect -> audit -> bankrupt protect -> verify)
inspect-release <target> Read-only local source-map & symbol exposure check
audit <target> Pre-flight REA exposure & vulnerability scan
lint-lanes <file> Heuristic warn if gate code looks lane-independent (issue #40.1)
lint-lanes <file> Heuristic ERROR if gate code looks lane-independent (issue #40.1); exit 2
protect <target> Inject multi-layer Counter-REA adversarial shield
verify <target> [original] Verify Counter-REA defense invariants & token amplification
benchmark Run the 14-target Counter-REA Showcase Benchmark suite
@@ -72,6 +72,7 @@ Options:
--weave-decoys Opt-in structural weave decoys (Python customer-def / .pyc co_consts weave; JS AST weave already on); OFF by default
--self-seal Opt-in self-seal / sibling-module integrity binding for JS/Node targets (issue #40.5); OFF by default
--wasm-preserve-exports <a,b> Comma-separated WASM export names to keep as public ABI (issue #40.3)
--allow-lane-independent Allow harden/defend of lane-independent JS gates (issue #40.1); OFF by default
--lang <c|rust|go> Target language for emit-headers (default: c)
--client <id> Agent client ID for setup (repeatable: claude_code, cursor, codex, etc.)
--all-detected Configure all detected coding agents on this machine
@@ -96,6 +97,7 @@ interface ParsedCliArgs {
readonly weaveDecoys: boolean;
readonly selfSeal: boolean;
readonly wasmPreserveExports: readonly string[];
readonly allowLaneIndependentGates: boolean;
readonly lang: NativeHeaderLanguage;
readonly clients: SupportedAgentClientId[];
readonly allDetected: boolean;
@@ -122,6 +124,7 @@ export function parseCliArgs(argv: readonly string[]): ParsedCliArgs {
let weaveDecoys = false;
let selfSeal = false;
let wasmPreserveExports: string[] = [];
let allowLaneIndependentGates = false;
let lang: NativeHeaderLanguage = "c";
const clients: SupportedAgentClientId[] = [];
let allDetected = false;
@@ -162,6 +165,8 @@ export function parseCliArgs(argv: readonly string[]): ParsedCliArgs {
weaveDecoys = true;
} else if (arg === "--self-seal") {
selfSeal = true;
} else if (arg === "--allow-lane-independent") {
allowLaneIndependentGates = true;
} else if (arg.startsWith("--wasm-preserve-exports=")) {
wasmPreserveExports = arg
.slice("--wasm-preserve-exports=".length)
@@ -217,6 +222,7 @@ export function parseCliArgs(argv: readonly string[]): ParsedCliArgs {
weaveDecoys,
selfSeal,
wasmPreserveExports,
allowLaneIndependentGates,
lang,
clients,
allDetected,
@@ -348,6 +354,9 @@ export async function runCli(argv: readonly string[] = process.argv.slice(2)): P
const merged = [...new Set([...fromCfg, ...fromCli])];
return merged.length > 0 ? { wasmPreserveExports: merged } : {};
})()),
allowLaneIndependentGates:
parsed.allowLaneIndependentGates ||
loaded.config.allowLaneIndependentGates === true,
...(parsed.output !== undefined ? { outputDirectory: parsed.output } : {}),
});
if (parsed.json) {
@@ -388,6 +397,9 @@ export async function runCli(argv: readonly string[] = process.argv.slice(2)): P
const merged = [...new Set([...fromCfg, ...fromCli])];
return merged.length > 0 ? { wasmPreserveExports: merged } : {};
})()),
allowLaneIndependentGates:
parsed.allowLaneIndependentGates ||
loaded.config.allowLaneIndependentGates === true,
});
if (parsed.sarif) {
console.log(
@@ -474,6 +486,9 @@ export async function runCli(argv: readonly string[] = process.argv.slice(2)): P
const merged = [...new Set([...fromCfg, ...fromCli])];
return merged.length > 0 ? { wasmPreserveExports: merged } : {};
})()),
allowLaneIndependentGates:
parsed.allowLaneIndependentGates ||
loaded.config.allowLaneIndependentGates === true,
});
if (parsed.json) console.log(JSON.stringify(res, null, 2));
else console.log(formatProtectionResult(res));
+2
View File
@@ -22,6 +22,8 @@ export interface BlaProjectConfig {
readonly selfSeal?: boolean;
/** WASM export names that must remain the public ABI when export rename runs (issue #40.3). */
readonly wasmPreserveExports?: readonly string[];
/** When true, allow harden/defend of lane-independent JS gates (issue #40.1). Default false. */
readonly allowLaneIndependentGates?: boolean;
}
/**
+7 -1
View File
@@ -171,9 +171,15 @@ export interface ProtectionOptions {
readonly selfSeal?: boolean;
/**
* WASM public ABI export names to keep when rename runs (issue #40.3).
* Other / internal-looking exports may be renamed at maximum/bankrupt.
* At maximum/bankrupt every non-listed export is renamed by default —
* preserving a stable ABI requires an explicit list.
*/
readonly wasmPreserveExports?: readonly string[];
/**
* When true, allow protecting JS/TS that looks lane-independent (issue #40.1).
* Default false: protect/defend/harden refuse such gates (red-blue round-1).
*/
readonly allowLaneIndependentGates?: boolean;
}
export interface ProtectionMetrics {
+5
View File
@@ -29,6 +29,8 @@ export interface OneClickDefenseOptions {
readonly selfSeal?: boolean;
/** WASM public ABI export names to preserve when rename runs (issue #40.3). */
readonly wasmPreserveExports?: readonly string[];
/** Allow lane-independent JS gates (issue #40.1). Default false. */
readonly allowLaneIndependentGates?: boolean;
}
export interface OneClickDefenseStageSummary {
@@ -120,6 +122,9 @@ export function defendTarget(options: OneClickDefenseOptions): OneClickDefenseRe
...(options.wasmPreserveExports !== undefined && options.wasmPreserveExports.length > 0
? { wasmPreserveExports: options.wasmPreserveExports }
: {}),
...(options.allowLaneIndependentGates === true
? { allowLaneIndependentGates: true }
: {}),
honeySourceMaps: true,
});
+5
View File
@@ -103,6 +103,8 @@ export interface HardenProjectOptions {
readonly selfSeal?: boolean;
/** WASM public ABI export names to preserve when rename runs (issue #40.3). */
readonly wasmPreserveExports?: readonly string[];
/** Allow lane-independent JS gates (issue #40.1). Default false — refuse. */
readonly allowLaneIndependentGates?: boolean;
/** Optional output root; defaults to `<dir>/.bla-hardened`. */
readonly outputDirectory?: string;
readonly maxArtifacts?: number;
@@ -415,6 +417,9 @@ export function hardenProject(
options.wasmPreserveExports.length > 0
? { wasmPreserveExports: options.wasmPreserveExports }
: {}),
...(options.allowLaneIndependentGates === true
? { allowLaneIndependentGates: true }
: {}),
emitManifest,
});
summaries.push({
+28 -4
View File
@@ -154,7 +154,12 @@ export const BLA_MCP_TOOLS: readonly McpToolDefinition[] = Object.freeze([
type: "array",
items: { type: "string" },
description:
"WASM export names that must remain the public ABI when export rename runs at maximum/bankrupt (issue #40.3).",
"WASM export names to keep as the public ABI. At maximum/bankrupt every other export is renamed by default — pass explicitly to keep mix/seal-style names (issue #40.3 / red-blue round-1).",
},
allow_lane_independent: {
type: "boolean",
description:
"Allow harden/defend/protect of JS/TS that looks lane-independent (per-byte oracles). Default false — refuse (issue #40.1 / red-blue round-1).",
},
seed: {
type: "string",
@@ -244,7 +249,12 @@ export const BLA_MCP_TOOLS: readonly McpToolDefinition[] = Object.freeze([
type: "array",
items: { type: "string" },
description:
"WASM export names that must remain the public ABI when export rename runs at maximum/bankrupt (issue #40.3).",
"WASM export names to keep as the public ABI. At maximum/bankrupt every other export is renamed by default — pass explicitly to keep mix/seal-style names (issue #40.3 / red-blue round-1).",
},
allow_lane_independent: {
type: "boolean",
description:
"Allow harden/defend/protect of JS/TS that looks lane-independent (per-byte oracles). Default false — refuse (issue #40.1 / red-blue round-1).",
},
seed: {
type: "string",
@@ -315,7 +325,12 @@ export const BLA_MCP_TOOLS: readonly McpToolDefinition[] = Object.freeze([
type: "array",
items: { type: "string" },
description:
"WASM export names that must remain the public ABI when export rename runs at maximum/bankrupt (issue #40.3).",
"WASM export names to keep as the public ABI. At maximum/bankrupt every other export is renamed by default — pass explicitly to keep mix/seal-style names (issue #40.3 / red-blue round-1).",
},
allow_lane_independent: {
type: "boolean",
description:
"Allow harden/defend/protect of JS/TS that looks lane-independent (per-byte oracles). Default false — refuse (issue #40.1 / red-blue round-1).",
},
seed: {
type: "string",
@@ -503,7 +518,7 @@ export const BLA_MCP_TOOLS: readonly McpToolDefinition[] = Object.freeze([
{
name: "bla_lint_lanes",
description:
"Read-only heuristic lane-independence footgun lint (same engine as CLI `bla lint-lanes`). Warns when gate/activation source looks like independent per-lane checks. Defensive guidance only — prefer whole-key chained mixing. Writes nothing.",
"Read-only heuristic lane-independence footgun lint (same engine as CLI `bla lint-lanes`). Returns severity-error findings when gate/activation source looks like independent per-lane checks. Harden refuses such gates unless allow_lane_independent. Prefer whole-key chained mixing. Writes nothing.",
inputSchema: {
type: "object",
properties: {
@@ -765,6 +780,9 @@ function runDefend(handlers: McpEngineHandlers, args: Record<string, unknown>):
weaveDecoys: Boolean(args.weave_decoys),
selfSeal: Boolean(args.self_seal),
...(wasmPreserveExports !== undefined ? { wasmPreserveExports } : {}),
...(args.allow_lane_independent === true
? { allowLaneIndependentGates: true }
: {}),
...(typeof args.seed === "string" ? { seed: args.seed } : {}),
});
}
@@ -786,6 +804,9 @@ function runProtect(handlers: McpEngineHandlers, args: Record<string, unknown>):
? { honeySourceMaps: args.honey_source_maps }
: {}),
...(wasmPreserveExports !== undefined ? { wasmPreserveExports } : {}),
...(args.allow_lane_independent === true
? { allowLaneIndependentGates: true }
: {}),
});
}
@@ -1261,6 +1282,9 @@ export async function handleMcpRequest(
weaveDecoys: Boolean(args.weave_decoys),
selfSeal: Boolean(args.self_seal),
...(wasmPreserveExports !== undefined ? { wasmPreserveExports } : {}),
...(args.allow_lane_independent === true
? { allowLaneIndependentGates: true }
: {}),
...(typeof args.seed === "string" ? { seed: args.seed } : {}),
});
// Dry-run / confirmation_required leave no write receipt; real writes do.
@@ -0,0 +1,89 @@
import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { afterEach, describe, expect, it } from "vitest";
import { hardenProject } from "../src/engine/harden.js";
import { protectTarget } from "../src/engine/protector.js";
const dirs: string[] = [];
afterEach(() => {
for (const d of dirs.splice(0)) rmSync(d, { recursive: true, force: true });
});
const INDEPENDENT_GATE = `
const lanes = [0x41, 0x42, 0x43, 0x44, 0x45];
export function check(key) {
return key.split("").every((ch, i) => ch.charCodeAt(0) === lanes[i]);
}
`;
const WHOLE_KEY_GATE = `
export function activate(key) {
let a = 0, b = 1;
for (let i = 0; i < key.length; i++) {
a = (a + key.charCodeAt(i) * (i + 3)) | 0;
b = Math.imul(b ^ a, 0x01000193) | 0;
}
return (a ^ b) === 0x12345678;
}
`;
describe("harden/protect lane-independence gate (red-blue round-1 P0)", () => {
it("refuses independent 1-byte lane JS by default", () => {
const root = mkdtempSync(join(tmpdir(), "bla-lane-refuse-"));
dirs.push(root);
const src = join(root, "gate.js");
writeFileSync(src, INDEPENDENT_GATE, "utf8");
expect(() =>
protectTarget({
inputPath: src,
outputPath: join(root, "out.js"),
intensity: "balanced",
seed: "lane-refuse",
}),
).toThrow(/allowLaneIndependentGates|lane-independent/i);
const app = join(root, "app");
mkdirSync(app);
writeFileSync(join(app, "gate.js"), INDEPENDENT_GATE, "utf8");
const report = hardenProject({
directory: app,
intensity: "stealth",
seed: "lane-refuse-harden",
outputDirectory: join(root, "hardened"),
});
expect(report.overallSuccess).toBe(false);
expect(report.artifacts.some((a) => a.error && /lane-independent|allowLaneIndependent/i.test(a.error))).toBe(
true,
);
});
it("passes whole-key mixing without allow flag", () => {
const root = mkdtempSync(join(tmpdir(), "bla-lane-ok-"));
dirs.push(root);
const src = join(root, "gate.js");
writeFileSync(src, WHOLE_KEY_GATE, "utf8");
const res = protectTarget({
inputPath: src,
outputPath: join(root, "out.js"),
intensity: "balanced",
seed: "lane-ok",
});
expect(res.outputPath).toBe(join(root, "out.js"));
});
it("allows independent lanes only with allowLaneIndependentGates", () => {
const root = mkdtempSync(join(tmpdir(), "bla-lane-allow-"));
dirs.push(root);
const src = join(root, "gate.js");
writeFileSync(src, INDEPENDENT_GATE, "utf8");
const res = protectTarget({
inputPath: src,
outputPath: join(root, "out.js"),
intensity: "balanced",
seed: "lane-allow",
allowLaneIndependentGates: true,
});
expect(res.outputPath).toBe(join(root, "out.js"));
});
});
@@ -22,6 +22,7 @@ const EXPECTED_MCP_ENGINE_CAPABILITIES: ReadonlyArray<{
"weave_decoys",
"self_seal",
"wasm_preserve_exports",
"allow_lane_independent",
"seed",
"dry_run",
"max_artifacts",
@@ -44,6 +45,7 @@ const EXPECTED_MCP_ENGINE_CAPABILITIES: ReadonlyArray<{
"weave_decoys",
"self_seal",
"wasm_preserve_exports",
"allow_lane_independent",
"seed",
"in_place",
"confirm_overwrite",
@@ -58,6 +60,7 @@ const EXPECTED_MCP_ENGINE_CAPABILITIES: ReadonlyArray<{
"weave_decoys",
"self_seal",
"wasm_preserve_exports",
"allow_lane_independent",
"seed",
"llm_directives",
"in_place",