@getbourdon/conformance

@getbourdon/conformance

Language-neutral cross-implementation parity fixtures for Bourdon.

Python (pip install bourdon) is the oracle. The @getbourdon/* TypeScript mirror is conformant iff it reproduces the oracle's output on these exact fixtures — byte-for-byte where the contract is bytes (redaction, recognition strings, MCP wire), value-for-value where it's structured (F1, schema validity, tool I/O).

The fixtures are generated by the Python repo's tools/gen_conformance.py (the single writer) and consumed by both the Python test suite and the TS vitest suite. This package ships them with typed loaders.

import { loadRedactionBattery, assembleSecret } from "@getbourdon/conformance";

const battery = loadRedactionBattery();
for (const secret of battery.secrets) {
  // a faithful TS redaction port must produce battery's expected output:
  expect(redactText(assembleSecret(secret))).toBe(secret.expect_redacted);
}

Resolution (Phase 0–1): BOURDON_CONFORMANCE_DIR, else the sibling Python checkout ../bourdon/conformance. Once published, the fixtures ship inside this package.

License: Apache-2.0 (the wire-contract surface is permissive so third parties can build conformant implementations). The Bourdon engine is BUSL-1.1.