Skip to main content

Benchmark assets, reproducibility tooling, and evidence checks for dormant behavior audit.

Project description

Dormant Behavior Audit

PyPI version Homepage Benchmark release Zenodo DOI

This repository contains the flagship benchmark assets, reference bundle, and reproducibility materials for auditing latent, condition-dependent model behavior.

The motivating historical case is the Jane Street dormant-model puzzle, but the repo is now organized as a public benchmark and research release rather than a contest-only submission package.

Slow Tour

A minimal starry-night terminal animation showing the slow benchmark flow from charter to reference bundle to reproduction to claim checks to release.

A quiet walk through the release path: open the charter, inspect the reference bundle, rerun the evidence, compare claim checks, and package the release.

Start Here

If you want the quickest tour, read these in order:

  1. benchmarks/BENCHMARK_CHARTER.md
  2. findings/RELEASE_PACKET_V2.md
  3. benchmarks/reference/dormant_puzzle_v1/benchmark_bundle_v0.json
  4. PUBLIC_RELEASE_CHECKLIST.md
  5. CONTRIBUTING.md

Install The CLI

The repository now builds as a Python package with a unified dba command.

The current live package release is 1.0.1 on PyPI. A sanitized package refresh 1.0.2 is prepared and ready to publish once PyPI Trusted Publishing is configured. The frozen benchmark/report bundle remains the tagged research release v1.0.0.

pipx install dormant-behavior-audit
dba --help

For a local one-off run without a permanent install:

uvx --from dormant-behavior-audit dba --help

Optional extras:

  • pipx install 'dormant-behavior-audit[tui]' for the Orbit Textual UI
  • pipx install 'dormant-behavior-audit[notebooks]' for notebook-heavy local analysis

The default install is intentionally substantial because it includes the research stack needed for reproduction and analysis, not just a lightweight wrapper CLI.

What This Repo Ships

Public-facing research packet

Benchmark assets

Reproducibility artifacts

Benchmark Shape

The current benchmark release has three layers:

  • core local seeded and clean-control tasks,
  • a naturalistic historical reference bundle built from the dormant puzzle result,
  • and a supplementary hosted-comparator lane used for calibration and mechanism interpretation.

The benchmark is designed to reward:

  • family recovery instead of one lucky string guess,
  • candidate-versus-control specificity,
  • repeated-run stability,
  • interpretation-aware reporting,
  • and artifact-rich submission packets instead of one scalar score.

Reproducing The Reference Case

Install dependencies:

pip install -r requirements.txt

Run the reproducibility pipeline:

python3 scripts/reproduce_submission.py

This writes a fresh bundle under artifacts/reproduction/<timestamp>/.

Use these files to judge success:

  • artifacts/reproduction/<timestamp>/reproduction_report.md
  • artifacts/reproduction/<timestamp>/findings/claim_consistency_report.md

Important notes:

  • local warmup stages are expected to reproduce on MPS-capable hardware,
  • API-side artifacts are stochastic, so claim-level consistency matters more than exact JSON replay,
  • and scripts/reproduce_submission.py --warmup-start-stage ... can resume a late warmup failure without rerunning the entire local sweep.

Repo Map

  • benchmarks/: benchmark specs, tasks, schemas, public-release drafts, and the normalized reference bundle
  • findings/: public report packet, appendices, raw evidence snapshots, and release-facing validation records
  • artifacts/: checked-in submission packets, reproduction bundles, tightening bundles, and hosted-baseline outputs
  • scripts/: bundle builders, release checkers, reproducibility scripts, and analysis utilities
  • src/, orbit/, problems/: earlier investigation and local-analysis surfaces preserved for provenance and follow-on work

Release Status

The canonical release metadata lives in benchmarks/public/release_metadata.json.

Current public release URLs:

The working launch checklist is still preserved in PUBLIC_RELEASE_CHECKLIST.md as the release record.

Licensing

  • Code, scripts, and schemas: Apache-2.0 via LICENSE
  • Public-facing reports, benchmark docs, and release artifacts: CC BY 4.0 via LICENSE-docs.md

Related Docs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dormant_behavior_audit-1.0.2.tar.gz (1.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dormant_behavior_audit-1.0.2-py3-none-any.whl (1.9 MB view details)

Uploaded Python 3

File details

Details for the file dormant_behavior_audit-1.0.2.tar.gz.

File metadata

  • Download URL: dormant_behavior_audit-1.0.2.tar.gz
  • Upload date:
  • Size: 1.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for dormant_behavior_audit-1.0.2.tar.gz
Algorithm Hash digest
SHA256 33a39dcfa46c912bba6473a5abfe6390f7fc42b37caa073c5a5edfbe4ae136b0
MD5 e27a3268cff1e485825ee40d06ecd626
BLAKE2b-256 553804eb4fd80a1fb4a7b5e531e0edc20e4999081917d27ae5e86096fe8b6e1f

See more details on using hashes here.

Provenance

The following attestation bundles were made for dormant_behavior_audit-1.0.2.tar.gz:

Publisher: publish-pypi.yml on SproutSeeds/dormant-behavior-audit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dormant_behavior_audit-1.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for dormant_behavior_audit-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 21cfdf668433511953c718b5612e813777f0aa9695015db80da00c929d0bae25
MD5 14544dc7d5f50bb8efcbb994482f5565
BLAKE2b-256 1d70a307e439dc9df39ab7c919f943042b411e2a3992c7346d3e8abef73177d7

See more details on using hashes here.

Provenance

The following attestation bundles were made for dormant_behavior_audit-1.0.2-py3-none-any.whl:

Publisher: publish-pypi.yml on SproutSeeds/dormant-behavior-audit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page