🛡️ 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(gates): emit + lint integrity-coverage on self-seal harden
qybaihea96d871e94b9
diff --git a/src/engine/harden.ts b/src/engine/harden.tsindex 032e807..34d83ef 100644--- a/src/engine/harden.ts+++ b/src/engine/harden.ts@@ -34,6 +34,7 @@ import {import {evaluateHardenProjectPackagingBlocks,} from "./packaging-gates.js";+import { planSidecarEntanglement } from "../shields/runtime/sidecar-entangle.js";import {computeHardenRunId,HARDEN_SUMMARY_FILE_NAME,@@ -185,6 +186,8 @@ export interface HardenProjectReport {readonly runId: string;/** Absolute path of the unsigned summary when written; omitted on dry-run. */readonly summaryPath?: string;+ /** Absolute path of bla-integrity-coverage/v1 matrix when selfSeal wrote one. */+ readonly integrityCoveragePath?: string;}export interface HardenDiscoveryResult {@@ -705,6 +708,39 @@ export function hardenProject(}}+ let integrityCoveragePath: string | undefined;+ if (options.selfSeal === true && !dryRun && summaries.some((s) => s.success)) {+ try {+ const jsLike = summaries.filter(+ (s) =>+ s.success &&+ /\.(mjs|cjs|js|ts|tsx|jsx)$/i.test(s.relativePath.replaceAll("\\", "/")),+ );+ const entry =+ jsLike.find((s) => /license\.(cjs|js)$/i.test(s.relativePath)) ??+ jsLike[0];+ if (entry) {+ const sidecars = summaries+ .filter((s) => s.success && s.relativePath !== entry.relativePath)+ .map((s) => s.relativePath.replaceAll("\\", "/"));+ const plan = planSidecarEntanglement({+ entryPath: entry.relativePath.replaceAll("\\", "/"),+ sidecarPaths: sidecars,+ seedTag: String(options.seed ?? runId),+ baseDir: outputRoot,+ });+ integrityCoveragePath = join(outputRoot, "integrity-coverage.json");+ writeFileSync(+ integrityCoveragePath,+ `${JSON.stringify(plan.coverageMatrix, null, 2)}\n`,+ "utf8",+ );+ }+ } catch {+ integrityCoveragePath = undefined;+ }+ }+const hardenedCount = summaries.filter((s) => s.success).length;const failedCount = summaries.length - hardenedCount;return {@@ -714,6 +750,9 @@ export function hardenProject(failedCount,artifacts: summaries,...(summaryPath !== undefined ? { summaryPath } : {}),+ ...(integrityCoveragePath !== undefined+ ? { integrityCoveragePath }+ : {}),};}diff --git a/src/engine/packaging-gates.ts b/src/engine/packaging-gates.tsindex 161f074..19a00da 100644--- a/src/engine/packaging-gates.ts+++ b/src/engine/packaging-gates.ts@@ -65,6 +65,11 @@ import {plaintextSecretRefuseMessage,type PlaintextSecretReport,} from "./plaintext-secret-lint.js";+import {+ discoverAndLintIntegrityCoverage,+ integrityCoverageRefuseMessage,+ type IntegrityCoverageFileReport,+} from "./integrity-coverage.js";export const PACKAGING_GATES_SCHEMA = "bla-packaging-gates/v1" as const;@@ -77,7 +82,8 @@ export type PackagingGateId =| "wasm-seal-xor-known-plaintext"| "lane-independence"| "panel-derive"- | "plaintext-secret";+ | "plaintext-secret"+ | "integrity-coverage";export interface PackagingGateFinding {readonly gate: PackagingGateId;@@ -100,6 +106,8 @@ export interface PackagingGatesAllowOptions {readonly allowPanelOfflineOracle?: boolean;readonly allowStablePanelDeriveAbi?: boolean;readonly allowPlaintextString?: boolean;+ /** Lab escape: allow bankrupt despite failing integrity coverage matrix. */+ readonly allowSinglePointIntegrity?: boolean;}export interface PackagingGatesScanOptions extends PackagingGatesAllowOptions {@@ -136,6 +144,7 @@ export interface PackagingGatesReport {readonly lanes: ReadonlyArray<LaneIndependenceReport & { readonly path: string }>;readonly panelDerive: readonly PanelDeriveAbiReport[];readonly plaintextSecrets: readonly PlaintextSecretReport[];+ readonly integrityCoverage: readonly IntegrityCoverageFileReport[];};}@@ -158,6 +167,7 @@ function emptyCounts(): Record<PackagingGateId, number> {"lane-independence": 0,"panel-derive": 0,"plaintext-secret": 0,+ "integrity-coverage": 0,};}@@ -187,6 +197,7 @@ export function scanPackagingGates(const plaintextSecrets = discoverAndLintPlaintextSecrets(absDir, {allowPlaintextString: options.allowPlaintextString,});+ const integrityCoverage = discoverAndLintIntegrityCoverage(absDir);const findings: PackagingGateFinding[] = [];const counts = emptyCounts();@@ -328,6 +339,21 @@ export function scanPackagingGates(findingCount: r.findings.length,});}+ for (const r of integrityCoverage) {+ if (r.ok && !r.shouldRefuseBankrupt) continue;+ counts["integrity-coverage"] += 1;+ findings.push({+ gate: "integrity-coverage",+ path: r.path,+ relativePath: relPath(absDir, r.path),+ shouldRefuseBankrupt: r.shouldRefuseBankrupt,+ refuseMessage: r.shouldRefuseBankrupt+ ? integrityCoverageRefuseMessage(r, r.path)+ : undefined,+ oneLineAdvice: r.oneLineAdvice,+ findingCount: r.reasons.length,+ });+ }const blocking = filterBlockingFindings(findings, intensity, options);@@ -358,6 +384,7 @@ export function scanPackagingGates(lanes,panelDerive,plaintextSecrets,+ integrityCoverage,},};}@@ -417,6 +444,12 @@ function filterBlockingFindings(allow.allowPlaintextString !== true &&f.shouldRefuseBankrupt);+ case "integrity-coverage":+ return (+ intensity === "bankrupt" &&+ allow.allowSinglePointIntegrity !== true &&+ f.shouldRefuseBankrupt+ );default:return false;}diff --git a/src/index.ts b/src/index.tsindex b303d99..cb1f857 100644--- a/src/index.ts+++ b/src/index.ts@@ -242,6 +242,16 @@ export {type SelfSealOptions,type SelfSealSnippet,} from "./shields/runtime/self-seal.js";+export {+ INTEGRITY_COVERAGE_SCHEMA,+ buildInterleavedCoverageMatrix,+ evaluateCoverageMatrix,+ finalizeCoverageMatrixHashes,+ discoverAndLintIntegrityCoverage,+ type CoverageMatrix,+ type CoverageEvaluation,+ type CoverageRefuseReason,+} from "./engine/integrity-coverage.js";export * from "./shields/formats/apple-plist.js";export * from "./shields/formats/dotnet-managed.js";export * from "./shields/formats/jvm-bytecode.js";