Benchmark assets, reproducibility tooling, and evidence checks for dormant behavior audit.
Project description
Dormant Behavior Audit
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 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:
- benchmarks/BENCHMARK_CHARTER.md
- findings/RELEASE_PACKET_V2.md
- benchmarks/reference/dormant_puzzle_v1/benchmark_bundle_v0.json
- PUBLIC_RELEASE_CHECKLIST.md
- 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 UIpipx 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
- Reference report index: findings/RELEASE_PACKET_V2.md
- Canonical report PDF: https://github.com/SproutSeeds/dormant-behavior-audit/releases/download/v1.0.0/dormant-behavior-audit-v1.0.0-reference-report.pdf
- Repo copy of report PDF: findings/CodyMitchell_DormantPuzzle_Submission_V2_2026-03-06.pdf
- Preprint candidate PDF: findings/DormantBehaviorAudit_ReferenceCase_Preprint_2026-04-07.pdf
- Preprint LaTeX source: findings/PREPRINT_SUBMISSION.tex
- Main report markdown: findings/SUBMISSION_V2.md
- Statistical appendix: findings/STATS_ADDENDUM_V2.md
- Raw evidence appendix: findings/RAW_EVIDENCE_APPENDIX_V2.md
- Implications memo: findings/IMPLICATIONS_AND_APPLICATIONS_APPENDIX_V2.md
Benchmark assets
- Benchmark overview: benchmarks/README.md
- Benchmark charter: benchmarks/BENCHMARK_CHARTER.md
- Launch plan: benchmarks/LAUNCH_PLAN.md
- Governance/versioning: benchmarks/GOVERNANCE_AND_VERSIONING.md
- Public launch drafts: benchmarks/public/README.md
- Release notes: benchmarks/public/RELEASE_NOTES_v1.0.0.md
- Collaboration brief: benchmarks/public/COLLABORATION_BRIEF.md
- Standalone homepage: https://sproutseeds.github.io/dormant-behavior-audit/
- Frozen reference bundle: benchmarks/reference/dormant_puzzle_v1/benchmark_bundle_v0.json
Reproducibility artifacts
- Canonical reproduction bundle: artifacts/reproduction/20260305_230206/
- Tightening bundle: artifacts/tightening/20260306_075440/
- Claim-level consistency report: artifacts/reproduction/20260305_230206/findings/claim_consistency_report.md
- Bundle checker entry point: scripts/check_benchmark_bundle.py
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.mdartifacts/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 bundlefindings/: public report packet, appendices, raw evidence snapshots, and release-facing validation recordsartifacts/: checked-in submission packets, reproduction bundles, tightening bundles, and hosted-baseline outputsscripts/: bundle builders, release checkers, reproducibility scripts, and analysis utilitiessrc/,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:
- repository: https://github.com/SproutSeeds/dormant-behavior-audit
- canonical benchmark release: https://github.com/SproutSeeds/dormant-behavior-audit/releases/tag/v1.0.0
- canonical reference report PDF: https://github.com/SproutSeeds/dormant-behavior-audit/releases/download/v1.0.0/dormant-behavior-audit-v1.0.0-reference-report.pdf
- canonical reference bundle: https://github.com/SproutSeeds/dormant-behavior-audit/releases/download/v1.0.0/dormant-behavior-audit-v1.0.0-reference-bundle.json
- package release on PyPI: https://pypi.org/project/dormant-behavior-audit/
- Hugging Face dataset entry: https://huggingface.co/datasets/sproutseeds/dormant-behavior-audit
- Zenodo DOI: https://doi.org/10.5281/zenodo.19475781
- reference report markdown: https://github.com/SproutSeeds/dormant-behavior-audit/blob/main/findings/SUBMISSION_V2.md
- benchmark homepage: https://sproutseeds.github.io/dormant-behavior-audit/
The working launch checklist is still preserved in PUBLIC_RELEASE_CHECKLIST.md as the release record.
Licensing
- Code, scripts, and schemas:
Apache-2.0via LICENSE - Public-facing reports, benchmark docs, and release artifacts:
CC BY 4.0via LICENSE-docs.md
Related Docs
- Public release checklist: PUBLIC_RELEASE_CHECKLIST.md
- Prepared package refresh notes: benchmarks/public/PACKAGE_RELEASE_NOTES_v1.0.2.md
- PyPI publishing guide: PYPI_PUBLISHING.md
- Preprint build script: scripts/build_preprint_pdf.sh
- Contributing guide: CONTRIBUTING.md
- Findings guide: findings/README.md
- Collaboration brief: benchmarks/public/COLLABORATION_BRIEF.md
- Benchmark governance: benchmarks/GOVERNANCE_AND_VERSIONING.md
- External platform status: benchmarks/public/EXTERNAL_PLATFORM_STATUS.md
- Hugging Face publish guide: benchmarks/public/HUGGINGFACE_PUBLISHING.md
- Preprint discoverability packet: benchmarks/public/PREPRINT_DISCOVERABILITY_PACKET.md
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
33a39dcfa46c912bba6473a5abfe6390f7fc42b37caa073c5a5edfbe4ae136b0
|
|
| MD5 |
e27a3268cff1e485825ee40d06ecd626
|
|
| BLAKE2b-256 |
553804eb4fd80a1fb4a7b5e531e0edc20e4999081917d27ae5e86096fe8b6e1f
|
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
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dormant_behavior_audit-1.0.2.tar.gz -
Subject digest:
33a39dcfa46c912bba6473a5abfe6390f7fc42b37caa073c5a5edfbe4ae136b0 - Sigstore transparency entry: 1258177723
- Sigstore integration time:
-
Permalink:
SproutSeeds/dormant-behavior-audit@e2fd8d85c7f48cac19ad70249d0863f9ba0638a6 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SproutSeeds
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@e2fd8d85c7f48cac19ad70249d0863f9ba0638a6 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file dormant_behavior_audit-1.0.2-py3-none-any.whl.
File metadata
- Download URL: dormant_behavior_audit-1.0.2-py3-none-any.whl
- Upload date:
- Size: 1.9 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
21cfdf668433511953c718b5612e813777f0aa9695015db80da00c929d0bae25
|
|
| MD5 |
14544dc7d5f50bb8efcbb994482f5565
|
|
| BLAKE2b-256 |
1d70a307e439dc9df39ab7c919f943042b411e2a3992c7346d3e8abef73177d7
|
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
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dormant_behavior_audit-1.0.2-py3-none-any.whl -
Subject digest:
21cfdf668433511953c718b5612e813777f0aa9695015db80da00c929d0bae25 - Sigstore transparency entry: 1258177766
- Sigstore integration time:
-
Permalink:
SproutSeeds/dormant-behavior-audit@e2fd8d85c7f48cac19ad70249d0863f9ba0638a6 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SproutSeeds
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@e2fd8d85c7f48cac19ad70249d0863f9ba0638a6 -
Trigger Event:
workflow_dispatch
-
Statement type: