Skip to content

v0.2.0

Latest

Choose a tag to compare

@kate8382 kate8382 released this 18 Nov 16:39
· 3 commits to main since this release

Release v0.2.0

Date: 2026-11-18
Milestone: Release v0.2.0

Summary

v0.2.0 delivers the core trial engine, fail-closed shape validation, metadata stabilization, the real_cases dataset framework, the benign_cases pipeline, and community cross-check adapters (bounty-scope and pgp-verify) backed by automated CI policy enforcement.

Architecture after this release: aura-pipeline-v4 (source: docs/diagrams/aura-pipeline-v4.mmd).

aura-pipeline-v4

Key Features & Epics

1. Community Adapters for Cross-Check Enforcement (Epic #28)

  • adapter:bounty-scope (#87): Offline, snapshot-based verification of bug bounty program metadata (HackerOne, Bugcrowd) using local snapshots (config/snapshots/bounty-programs.json). Implemented in #90.
  • adapter:pgp-verify (#88): Cryptographic PGP signature verification against a static local allowlist (scripts/policy/pgp/, openpgp 6.3.2). Implemented in #117.
  • Policy-as-Code Validation (#89): CI gate (npm run validate:keys) that checks manifest/directory synchronization, ASCII-armor format, fingerprint integrity, a 2-year maximum validity window, RSA ≥ 3072 bits, approved elliptic curves (Ed25519, NIST P-256/P-384/P-521), and rejects SHA-1 and MD5 signatures. Implemented in #141.

2. Real Cases Dataset & Pipeline (Epic #84)

  • Source/license audit, data-handling policy, and provenance fields per case (#78, #79).
  • Unified directory targeting (--dir/CASES_DIR) with real_cases validation in CI (#80).
  • Licensing split and third-party attribution in NOTICE (#81).
  • Pilot: 15 real prompts analyzed end to end, case ID scheme, and trigger cleanup (#82).
  • Documentation: README, contributor guide, and differences from synthetic_cases (#83).

3. Engine Robustness & Performance

  • Async Bulk I/O & Caching (#37): Resource caching and bounded concurrency for large dataset evaluations.
  • Strict Schema & Validation (#35, #38, #39): Tightened per-case schema with AJV validation, overlap detection for trigger/signal configs, and CI failure on unexpected silent errors.
  • Race fix (#34): updateCase() calls are awaited, so persisted confidence is no longer stale.
  • Recalc regression coverage (#36): Integration and regression tests for the recalc pipeline.
  • Metadata & Vocabulary Stability (#68, #69, #70): Versioned decision vocabulary and signal-catalog hash, action-type binding for egress checks, and declared-shape metadata with False Positive Rate (FPR) evaluation. Trial engine FPR integration: #104.
  • Dataset Separation (#106, #139): Renamed public_cases to synthetic_cases and introduced the benign_cases pipeline (safe and clarify cases).

Pull Requests Without a Linked Issue

  • #1 Compact signal IDs, structured categories, migration tools, docs and infra updates.
  • #11 Decision vs. confidence: policy mapping and schema.
  • #18 Confidence normalization, trigger weight retuning, removal of legacy fields, pipeline diagram.
  • #22 Policy evaluator fixes: veto, evasion, pending, thresholds.
  • #27 Machine-readable cross-check requirements and enforcement adapter.
  • #30 and #33 Rule-based trigger extraction and its hardening.
  • #55 Tiered TF-IDF trigger weighting.
  • #58 License changed to BSL-1.1 (dual with Apache on the change date).
  • #65 examples/ CLI demo and sample case.
  • #73 and #119 Trigger-weight regeneration.
  • #74 Reduced duplicate traffic workflow runs.
  • Automated traffic report and history updates (Update traffic ... workflow commits).

Known Limitations

  • RSA key size in the PGP validator: the policy minimum is RSA ≥ 3072 bits. openpgp.js cannot generate keys below 2047 bits, so the weak-RSA test uses RSA-2048 (rejected by the loader). The original spec example used RSA-1024.
  • Trusted-key allowlist is empty (config/trusted-keys/manifest.json, keys: []) by design until the first keys are approved.
  • npm audit reports 42 advisories (1 critical, 40 high, 1 moderate) in the development toolchain (mainly jest, ts-jest, @types/jest) and their transitive dependencies. They are not addressed in this release and are tracked in #142. They affect the build and test tooling, not the runtime code.

Upgrade Notes

  • package.json version is updated to 0.2.0.
  • Run npm run validate:keys locally to verify PGP trust-store changes.
  • References to public_cases should be updated to synthetic_cases in local custom scripts.