mirror of
https://github.com/qybaihe/bla.git
synced 2026-11-20 08:20:59 +08:00
953 B
953 B
Contributing to BLA (bla-shield)
Thank you for helping software developers fight back against automated AI reverse engineering!
Development Workflow
# Install dependencies
npm install
# Build TypeScript to dist/
npm run build
# Run the Vitest test suite
npm test
# Run the empirical Counter-REA benchmark
node dist/cli.js benchmark
Architecture Guidelines
- Zero Runtime Side Effects: Every AST transformation, opaque predicate, and binary section extension must be 100% side-effect free at runtime. Every shield must be verified by executing both the original and protected artifacts and asserting identical return values.
- Deterministic Builds: Always thread
SeededPrng(--seed) through new shield passes so builds are reproducible in CI/CD pipelines. - Target Real Analyzer Limits: When adding a new countermeasure, document the exact static/semantic analyzer heuristic or resource limit it defeats.