mirror of
https://github.com/qybaihe/bla.git
synced 2026-11-20 08:20:59 +08:00
Merge pull request #105 from DeryFerd/docs/drift-fixes
docs: align Node engine, release model, and benchmark figures with code
This commit is contained in:
@@ -8,7 +8,7 @@ This repository contains **BLA (`bla-agents` — Blind LLM Agents)**, an open-so
|
||||
- `src/core/`:
|
||||
- `types.ts`: Domain interfaces (`AuditReport`, `ProtectionResult`, `VerificationReport`, `BenchmarkReport`).
|
||||
- `detector.ts`: Magic-byte and file-extension format detection across 19 artifact types (including JS/TS, `.asar`, `.wasm`, `.py`/`.pyc`, ELF/Mach-O/PE, `.sqlite`, `.safetensors`, `.gguf`, `.dex`, and `Il2Cpp` metadata).
|
||||
- `sqlite-runtime.ts`: Lazy `node:sqlite` `DatabaseSync` loader validating Node `^22.13.0 || >=24.0.0`.
|
||||
- `sqlite-runtime.ts`: Lazy `node:sqlite` `DatabaseSync` loader validating Node `^22.23.4 || >=24.0.0`.
|
||||
- `output-path.ts`: Safe output path admission checks (`assertSafeOutputPath`).
|
||||
- `release-exposure.ts`: Bounded read-only source-map & symbol exposure scanner (`inspectReleaseExposure`).
|
||||
- `prng.ts`: Deterministic xorshift/mulberry32 PRNG (`SeededPrng`).
|
||||
|
||||
@@ -158,7 +158,7 @@ We do **not** claim those paths are empirically bankrupt until `redteam:rea` (or
|
||||
|
||||
`npx bla-agents benchmark` runs a **local Counter-REA showcase**: exposure scores, **estimated** token/cost multipliers, and **measured** runtime equivalence. Token/$ columns are **internal estimates** derived from BLA's catalog of REA limits — they are **not** the same as the empirical REA process measurements above (those are byte-level analyzer failures with real error strings). `npm run verify:rea` is a **constant-drift harness only** and must never be cited as protection evidence; the only authoritative gate is `npm run redteam:rea`.
|
||||
|
||||
Latest local run (bla-agents **v1.4.0**): aggregate **~612.5×** tokens · **~292.2×** cost · **14/14** runtime-exact.
|
||||
Latest local run (bla-agents **v2.1.0**): aggregate **~639.5×** tokens · **~304.4×** cost · **14/14** runtime-exact.
|
||||
|
||||
| Target | Unprotected (est.) | Protected (est.) | Token mult (est.) | Runtime |
|
||||
| --- | --- | --- | ---: | :---: |
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**Version:** 2.1.0 (`package.json` ↔ `src/identity.ts`, verified by build; see `CHANGELOG.md`)
|
||||
**Status:** CI matrix runs typecheck, build, tests and the benchmark on ubuntu / macos / windows with Node 24. Windows checkouts keep `challenge/**` LF via `.gitattributes` so the CrackMe seals verify.
|
||||
**Publishing:** tag-only releases (`git tag bla-agents-<version>`); see `CHANGELOG.md` and GitHub Releases.
|
||||
**Publishing:** tagged releases (`git tag bla-agents-<version>`) plus GitHub Releases. The release workflow can also publish the packed tarball to npm with provenance when `NPM_TOKEN`/OIDC is configured; a release cut may intentionally skip the npm step (see `CHANGELOG.md`).
|
||||
|
||||
## One-sentence usage
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Installation & Setup Guide
|
||||
|
||||
**BLA (`bla-agents` — Blind LLM Agents)** is distributed as a zero-config Node.js CLI and MCP server that runs anywhere Node.js `^22.13.0 || >=24.0.0` is installed.
|
||||
**BLA (`bla-agents` — Blind LLM Agents)** is distributed as a zero-config Node.js CLI and MCP server that runs anywhere Node.js `^22.23.4 || >=24.0.0` is installed (matches `package.json` `engines`).
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user