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(gates): emit + lint integrity-coverage on self-seal harden

qybaihea96d871e94b9
diff --git a/src/engine/harden.ts b/src/engine/harden.ts
index 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.ts
index 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.ts
index 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";