Releases and Downloads
BDL documentation, language contracts, knowledge baselines, and runtime guidance are versioned independently.
Do not treat all BDL-related version numbers as one shared version.
Current releases
The following packages are the current published reference packages for this documentation baseline.
BDL Knowledge Baseline
Version: 5.2.2 ALIGNED
Package: Barsa_BDL_Master_Knowledge_Pack_v5.2.2_ALIGNED_20260828.zip
This is the primary knowledge baseline used by the current BDL documentation.
Native Barsa Contract
Version: 2.0.0
Package: BARSA_NATIVE_SYSTEM_DESIGN_CONTRACT_v2.0.0.zip
Native Barsa behavior is versioned independently from the BDL language and knowledge baseline.
Runtime and Troubleshooting Knowledge
Version: 2.0.0 COMPLETE
Package: Barsa_RT_BDL_Troubleshooting_Knowledge_Pack_v2.0.0_COMPLETE_20260828.zip
This package contains runtime and troubleshooting knowledge used alongside the BDL reference.
Current documentation baseline
| Component | Current baseline |
|---|---|
| BDL Knowledge Baseline | 5.2.2 ALIGNED |
| BDL Language Family | barsa.definition.v1 |
| Native Barsa Contract | 2.0.0 |
| Runtime / Troubleshooting | 2.0.0 COMPLETE |
| Documentation Site | v1.2.0 |
Version dimensions
BDL uses several independent version dimensions.
BDL language version
The language version identifies the schema contract used by BDL documents.
{
"schema": "barsa.definition.v1"
}
Knowledge baseline
The knowledge baseline identifies the evidence and documentation baseline used to describe BDL behavior, artifact structure, and authoring rules.
Native Barsa contract version
Native Barsa behavior is governed by its own contract version.
Do not infer Native Contract compatibility from the BDL Knowledge Pack version number.
Runtime and troubleshooting version
Runtime and troubleshooting knowledge can evolve independently from both the language and Native Contract.
Download policy
Official downloadable packages are:
- Versioned
- Immutable after publication
- Clearly named
- Accompanied by release metadata
- Verifiable with SHA-256 checksums
- Clearly marked as current or historical
Package integrity
Every published package includes a SHA-256 checksum file.
Verify a downloaded package before using it as an authoritative reference baseline.
Machine-readable release information
BDL exposes machine-readable discovery and release metadata:
These files allow AI systems and automation to identify the active BDL documentation baseline without scraping this page.
Historical releases
Historical packages are retained for compatibility analysis, migration work, change comparison, and evidence review.
Historical packages are not the current recommended production baseline.
Historical Knowledge Packs
BDL Knowledge Pack v5.2 COMPLETE FINAL
Package: Barsa_BDL_Master_Knowledge_Pack_v5.2_COMPLETE_FINAL_20260828.zip
BDL Knowledge Pack v3.0
Package: Barsa-BDL-Master-Knowledge-Pack-v3.0-FINAL-RT-AUTHORING-SURFACE-20260816.zip
BDL Knowledge Pack v2.0
Package: Barsa-BDL-Master-Knowledge-Pack-v2.0-FINAL-20260816.zip
Historical Native Contracts
Native Barsa Contract v1.0.0
Package: BARSA_NATIVE_SYSTEM_DESIGN_CONTRACT_v1.0.0.zip
Archive policy
Historical releases remain immutable after publication.
They must not silently override the current BDL knowledge baseline, current Native Contract, or current troubleshooting guidance.
Use historical packages only when reproducing an older environment, comparing versions, or investigating compatibility changes.