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.

feat(mcp/cli): expose bla_lint_seal and allow_plaintext_seal

qybaihe01801b8c5f3e
diff --git a/src/cli.ts b/src/cli.ts
index 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 check
audit <target> Pre-flight REA exposure & vulnerability scan
lint-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 error
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
@@ -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)): P
allowLaneIndependentGates:
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)): P
allowLaneIndependentGates:
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)): P
allowLaneIndependentGates:
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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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();
+ });
+});