π‘οΈ 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
feat(mcp/cli): expose bla_lint_seal and allow_plaintext_seal
qybaihe01801b8c5f3e
diff --git a/src/cli.ts b/src/cli.tsindex 6076d79..634f3bb 100644--- a/src/cli.ts+++ b/src/cli.ts@@ -12,6 +12,7 @@ import { verifyTarget } from "./engine/verifier.js";import { defendTarget } from "./engine/defender.js";import { formatHardenProjectReport, hardenProject } from "./engine/harden.js";import { lintLaneIndependence } from "./engine/lane-independence-lint.js";+import { lintSealCommitmentFile } from "./engine/seal-commitment-lint.js";import { runShowcaseBenchmark } from "./engine/benchmark.js";import {emitCompileTimeNativeHeader,@@ -52,6 +53,7 @@ Commands:inspect-release <target> Read-only local source-map & symbol exposure checkaudit <target> Pre-flight REA exposure & vulnerability scanlint-lanes <file> Heuristic ERROR if gate code looks lane-independent (issue #40.1); exit 2+ lint-seal <file> Heuristic lint for plaintext/reversible seal sidecars (red-blue round-2); exit 2 on errorprotect <target> Inject multi-layer Counter-REA adversarial shieldverify <target> [original] Verify Counter-REA defense invariants & token amplificationbenchmark Run the 14-target Counter-REA Showcase Benchmark suite@@ -73,6 +75,7 @@ Options:--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+ --allow-plaintext-seal Allow bankrupt harden despite plaintext/reversible seal JSON (round-2); 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@@ -98,6 +101,7 @@ interface ParsedCliArgs {readonly selfSeal: boolean;readonly wasmPreserveExports: readonly string[];readonly allowLaneIndependentGates: boolean;+ readonly allowPlaintextSeal: boolean;readonly lang: NativeHeaderLanguage;readonly clients: SupportedAgentClientId[];readonly allDetected: boolean;@@ -125,6 +129,7 @@ export function parseCliArgs(argv: readonly string[]): ParsedCliArgs {let selfSeal = false;let wasmPreserveExports: string[] = [];let allowLaneIndependentGates = false;+ let allowPlaintextSeal = false;let lang: NativeHeaderLanguage = "c";const clients: SupportedAgentClientId[] = [];let allDetected = false;@@ -167,6 +172,8 @@ export function parseCliArgs(argv: readonly string[]): ParsedCliArgs {selfSeal = true;} else if (arg === "--allow-lane-independent") {allowLaneIndependentGates = true;+ } else if (arg === "--allow-plaintext-seal") {+ allowPlaintextSeal = true;} else if (arg.startsWith("--wasm-preserve-exports=")) {wasmPreserveExports = arg.slice("--wasm-preserve-exports=".length)@@ -223,6 +230,7 @@ export function parseCliArgs(argv: readonly string[]): ParsedCliArgs {selfSeal,wasmPreserveExports,allowLaneIndependentGates,+ allowPlaintextSeal,lang,clients,allDetected,@@ -357,6 +365,9 @@ export async function runCli(argv: readonly string[] = process.argv.slice(2)): PallowLaneIndependentGates:parsed.allowLaneIndependentGates ||loaded.config.allowLaneIndependentGates === true,+ allowPlaintextSeal:+ parsed.allowPlaintextSeal ||+ loaded.config.allowPlaintextSeal === true,...(parsed.output !== undefined ? { outputDirectory: parsed.output } : {}),});if (parsed.json) {@@ -400,6 +411,9 @@ export async function runCli(argv: readonly string[] = process.argv.slice(2)): PallowLaneIndependentGates:parsed.allowLaneIndependentGates ||loaded.config.allowLaneIndependentGates === true,+ allowPlaintextSeal:+ parsed.allowPlaintextSeal ||+ loaded.config.allowPlaintextSeal === true,});if (parsed.sarif) {console.log(@@ -440,6 +454,30 @@ export async function runCli(argv: readonly string[] = process.argv.slice(2)): P}return report.looksLaneIndependent ? 2 : 0;}+ case "lint-seal": {+ const target = parsed.positionals[0];+ if (!target) {+ console.error("Error: Missing <file> path for `bla lint-seal <file>`.");+ return 1;+ }+ const report = lintSealCommitmentFile(resolve(target));+ if (parsed.json) {+ console.log(JSON.stringify(report, null, 2));+ } else {+ console.log(`BLA seal-commitment lint β ${report.path}`);+ console.log(report.oneLineAdvice);+ for (const f of report.findings) {+ console.log(` [${f.severity}] ${f.id}: ${f.summary}`);+ if (f.evidence) console.log(` evidence: ${f.evidence}`);+ }+ if (report.findings.length === 0) {+ console.log(" (no findings)");+ }+ }+ return report.shouldRefuseBankrupt || report.findings.some((f) => f.severity === "error")+ ? 2+ : 0;+ }case "audit": {const loaded = loadBlaConfig(process.cwd(), parsed.configPath);const target = parsed.positionals[0] ?? loaded.config.input;@@ -489,6 +527,9 @@ export async function runCli(argv: readonly string[] = process.argv.slice(2)): PallowLaneIndependentGates:parsed.allowLaneIndependentGates ||loaded.config.allowLaneIndependentGates === true,+ allowPlaintextSeal:+ parsed.allowPlaintextSeal ||+ loaded.config.allowPlaintextSeal === true,});if (parsed.json) console.log(JSON.stringify(res, null, 2));else console.log(formatProtectionResult(res));diff --git a/src/mcp/server.ts b/src/mcp/server.tsindex 0eb2bb9..c8967c1 100644--- a/src/mcp/server.ts+++ b/src/mcp/server.ts@@ -13,6 +13,10 @@ import {lintLaneIndependence,type LaneIndependenceReport,} from "../engine/lane-independence-lint.js";+import {+ lintSealCommitmentFile,+ type SealCommitmentReport,+} from "../engine/seal-commitment-lint.js";import {computeArtifactRunId,readHardenRunSummary,@@ -161,6 +165,11 @@ export const BLA_MCP_TOOLS: readonly McpToolDefinition[] = Object.freeze([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).",},+ allow_plaintext_seal: {+ type: "boolean",+ description:+ "Allow bankrupt harden/protect despite plaintext or reversible seal/entitlement JSON sidecars. Default false β refuse (red-blue round-2).",+ },seed: {type: "string",description: "Optional deterministic seed; when omitted, BLA uses/persists a per-project random seed in .blarc",@@ -256,6 +265,11 @@ export const BLA_MCP_TOOLS: readonly McpToolDefinition[] = Object.freeze([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).",},+ allow_plaintext_seal: {+ type: "boolean",+ description:+ "Allow bankrupt harden/protect despite plaintext or reversible seal/entitlement JSON sidecars. Default false β refuse (red-blue round-2).",+ },seed: {type: "string",description: "Optional deterministic seed; when omitted, BLA uses/persists a per-project random seed in .blarc",@@ -332,6 +346,11 @@ export const BLA_MCP_TOOLS: readonly McpToolDefinition[] = Object.freeze([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).",},+ allow_plaintext_seal: {+ type: "boolean",+ description:+ "Allow bankrupt harden/protect despite plaintext or reversible seal/entitlement JSON sidecars. Default false β refuse (red-blue round-2).",+ },seed: {type: "string",description: "Optional deterministic seed; when omitted, BLA mints an ephemeral random seed (prefer project .blarc via CLI)",@@ -531,6 +550,22 @@ export const BLA_MCP_TOOLS: readonly McpToolDefinition[] = Object.freeze([additionalProperties: false,},},+ {+ name: "bla_lint_seal",+ description:+ "Read-only seal-commitment lint (same engine as CLI `bla lint-seal`). Flags plaintext seal/entitlement JSON sidecars and reversible public commitments (scheduleSalt+rounds+revision without a one-way algorithm). Bankrupt harden refuses error findings unless allow_plaintext_seal. Writes nothing.",+ inputSchema: {+ type: "object",+ properties: {+ path: {+ type: "string",+ description: "Path to a seal.json / *.seal.json (or seal-shaped JSON) file to lint",+ },+ },+ required: ["path"],+ additionalProperties: false,+ },+ },{name: "bla_run_lookup",description:@@ -783,6 +818,7 @@ function runDefend(handlers: McpEngineHandlers, args: Record<string, unknown>):...(args.allow_lane_independent === true? { allowLaneIndependentGates: true }: {}),+ ...(args.allow_plaintext_seal === true ? { allowPlaintextSeal: true } : {}),...(typeof args.seed === "string" ? { seed: args.seed } : {}),});}@@ -807,6 +843,7 @@ function runProtect(handlers: McpEngineHandlers, args: Record<string, unknown>):...(args.allow_lane_independent === true? { allowLaneIndependentGates: true }: {}),+ ...(args.allow_plaintext_seal === true ? { allowPlaintextSeal: true } : {}),});}@@ -833,6 +870,14 @@ function runLintLanes(args: Record<string, unknown>): LaneIndependenceReport {return lintLaneIndependence(source);}+function runLintSeal(args: Record<string, unknown>): SealCommitmentReport {+ const abs = resolvePath(args.path as string);+ if (!existsSync(abs)) {+ throw new Error(`lint-seal target not found: ${abs}`);+ }+ return lintSealCommitmentFile(abs);+}+export function validateMcpToolCall(params: unknown,):@@ -1285,6 +1330,7 @@ export async function handleMcpRequest(...(args.allow_lane_independent === true? { allowLaneIndependentGates: true }: {}),+ ...(args.allow_plaintext_seal === true ? { allowPlaintextSeal: true } : {}),...(typeof args.seed === "string" ? { seed: args.seed } : {}),});// Dry-run / confirmation_required leave no write receipt; real writes do.@@ -1398,6 +1444,9 @@ export async function handleMcpRequest(});} else if (name === "bla_lint_lanes") {payload = runLintLanes(args);+ } else if (name === "bla_lint_seal") {+ payload = runLintSeal(args);+ refused = (payload as SealCommitmentReport).shouldRefuseBankrupt;} else if (name === "bla_run_lookup") {payload = readHardenRunSummary(args.summary_path as string,diff --git a/tests/mcp-engine-capability-parity.test.ts b/tests/mcp-engine-capability-parity.test.tsindex ebbafce..d32c6c8 100644--- a/tests/mcp-engine-capability-parity.test.ts+++ b/tests/mcp-engine-capability-parity.test.ts@@ -23,6 +23,7 @@ const EXPECTED_MCP_ENGINE_CAPABILITIES: ReadonlyArray<{"self_seal","wasm_preserve_exports","allow_lane_independent",+ "allow_plaintext_seal","seed","dry_run","max_artifacts",@@ -46,6 +47,7 @@ const EXPECTED_MCP_ENGINE_CAPABILITIES: ReadonlyArray<{"self_seal","wasm_preserve_exports","allow_lane_independent",+ "allow_plaintext_seal","seed","in_place","confirm_overwrite",@@ -61,6 +63,7 @@ const EXPECTED_MCP_ENGINE_CAPABILITIES: ReadonlyArray<{"self_seal","wasm_preserve_exports","allow_lane_independent",+ "allow_plaintext_seal","seed","llm_directives","in_place",@@ -84,6 +87,10 @@ const EXPECTED_MCP_ENGINE_CAPABILITIES: ReadonlyArray<{tool: "bla_lint_lanes",params: ["path"],},+ {+ tool: "bla_lint_seal",+ params: ["path"],+ },{tool: "bla_run_lookup",params: ["summary_path", "run_id"],diff --git a/tests/mcp-lint-seal.test.ts b/tests/mcp-lint-seal.test.tsnew file mode 100644index 0000000..245ff7a--- /dev/null+++ b/tests/mcp-lint-seal.test.ts@@ -0,0 +1,77 @@+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";+import { tmpdir } from "node:os";+import { join } from "node:path";+import { afterEach, describe, expect, it } from "vitest";+import { handleMcpRequest, BLA_MCP_TOOLS } from "../src/mcp/server.js";+import { SEAL_COMMITMENT_SCHEMA } from "../src/engine/seal-commitment-lint.js";++const tempDirs: string[] = [];+afterEach(() => {+ for (const d of tempDirs.splice(0)) rmSync(d, { recursive: true, force: true });+});++async function call(name: string, args: Record<string, unknown>) {+ return handleMcpRequest({+ jsonrpc: "2.0",+ id: 1,+ method: "tools/call",+ params: { name, arguments: args },+ });+}++const ROUND2 = {+ schema: "bla-redblue-r2-seal/v1",+ rounds: 28,+ scheduleSalt: 1374179543,+ revision: "7f325fec37206b637a224e9630b67c4a",+ certificateCipherHex: "aabb",+};++const ONE_WAY = {+ schema: "bla-entitlement-seal/v1",+ algorithm: "sha256",+ revision: "b38091d4a394ded9012846e8d4b647083b260beb6ee5ad1e42265fe6f107c660",+};++describe("MCP bla_lint_seal", () => {+ it("is registered once", () => {+ expect(BLA_MCP_TOOLS.filter((t) => t.name === "bla_lint_seal")).toHaveLength(1);+ });++ it("flags reversible seal and sets isError", async () => {+ const dir = mkdtempSync(join(tmpdir(), "bla-mcp-seal-bad-"));+ tempDirs.push(dir);+ const file = join(dir, "seal.json");+ writeFileSync(file, JSON.stringify(ROUND2), "utf8");+ const res = await call("bla_lint_seal", { path: file });+ expect(res?.error).toBeUndefined();+ const result = res!.result as {+ isError?: boolean;+ structuredContent: {+ schema: string;+ shouldRefuseBankrupt: boolean;+ findings: ReadonlyArray<{ id: string; severity: string }>;+ };+ };+ expect(result.structuredContent.schema).toBe(SEAL_COMMITMENT_SCHEMA);+ expect(result.structuredContent.shouldRefuseBankrupt).toBe(true);+ expect(result.isError).toBe(true);+ expect(+ result.structuredContent.findings.some((f) => f.id === "reversible-public-commitment"),+ ).toBe(true);+ });++ it("passes one-way digest without refuse", async () => {+ const dir = mkdtempSync(join(tmpdir(), "bla-mcp-seal-ok-"));+ tempDirs.push(dir);+ const file = join(dir, "seal.json");+ writeFileSync(file, JSON.stringify(ONE_WAY), "utf8");+ const res = await call("bla_lint_seal", { path: file });+ const result = res!.result as {+ isError?: boolean;+ structuredContent: { shouldRefuseBankrupt: boolean };+ };+ expect(result.structuredContent.shouldRefuseBankrupt).toBe(false);+ expect(result.isError).toBeFalsy();+ });+});