# BDL - Barsa Definition Language

> Official governed AI discovery entry point for BDL.

Canonical site: https://bdl-lang.org
AI bootstrap: https://bdl-lang.org/ai-bootstrap.json
Full AI instructions: https://bdl-lang.org/llms-full.txt
AI corpus manifest: https://bdl-lang.org/ai-corpus/manifest.json
Current-source corpus: https://bdl-lang.org/ai-corpus/current-sources.jsonl
Contract corpus: https://bdl-lang.org/ai-corpus/contracts.jsonl
Catalog corpus: https://bdl-lang.org/ai-corpus/catalogs.jsonl
Source index: https://bdl-lang.org/ai-corpus/source-index.json
Supersession map: https://bdl-lang.org/ai-corpus/supersession-map.json
Discovery manifest: https://bdl-lang.org/ai-discovery.json
Release metadata: https://bdl-lang.org/bdl-release.json

## Current Governed Baseline

- Knowledge baseline: 5.2.2 ALIGNED
- Schema family: barsa.definition.v1
- Native Barsa contract: 2.0.0
- Runtime / Troubleshooting: 2.0.0 COMPLETE

## Governed Documentation

- [Getting Started](https://bdl-lang.org/docs/intro)
- [Language Overview](https://bdl-lang.org/docs/language/overview)
- [Source of Truth](https://bdl-lang.org/docs/reference/source-of-truth)
- [Artifact Reference](https://bdl-lang.org/docs/reference/artifacts)
- [Capability Model](https://bdl-lang.org/docs/reference/capabilities)
- [Versioning and Capability Governance](https://bdl-lang.org/docs/reference/versioning-capability-governance)
- [Validation](https://bdl-lang.org/docs/validation/overview)
- [Troubleshooting and Diagnostics](https://bdl-lang.org/docs/troubleshooting/overview)
- [Known Gaps](https://bdl-lang.org/docs/known-gaps/current)
- [Governed Patterns and Recipes Corpus](https://bdl-lang.org/docs/examples/governed-patterns)
- [Governed Validated Examples Corpus](https://bdl-lang.org/docs/examples/validated-corpus)
- [AI Authoring](https://bdl-lang.org/docs/ai/authoring)
- [Governed AI Knowledge Layer](https://bdl-lang.org/docs/ai/knowledge)
- [Releases](https://bdl-lang.org/docs/releases)

## AI Claim-Safety Rules

- Do not invent Native Barsa identifiers or unsupported state.
- Evaluate Native Barsa, Runtime Support, BDL Expressibility and BDL Authoring Availability separately.
- Absence of evidence is not evidence of unavailability.
- Parse, build or publication success does not prove runtime persistence or authoring availability.
- Preserve known gaps, unresolved ambiguity, conflicts and version qualifiers.
- Use governed validation, diagnostics and approval before mutation.

## Machine-Readable Discovery

- Discovery manifest: https://bdl-lang.org/ai-discovery.json
- AI knowledge bundle: https://bdl-lang.org/ai-knowledge.json
- Release metadata: https://bdl-lang.org/bdl-release.json
- AI knowledge output kind: bdl.documentation.phase46.ai-knowledge
- AI knowledge records: 1812
- AI knowledge publication state: published-static

Official domain: bdl-lang.org