# BDL AI-Complete Corpus

> Canonical machine-readable entry point for authoring BDL from bdl-lang.org.

## Start here
- https://bdl-lang.org/ai-bootstrap.json
- https://bdl-lang.org/llms-full.txt
- https://bdl-lang.org/ai-corpus/manifest.json
- https://bdl-lang.org/ai-discovery.json
- https://bdl-lang.org/ai-knowledge.json

## Bundles
- current_sources: https://bdl-lang.org/ai-corpus/current-sources.jsonl (75 records)
- knowledge_chunks: https://bdl-lang.org/ai-corpus/knowledge-chunks.jsonl (216 records)
- contracts: https://bdl-lang.org/ai-corpus/contracts.jsonl (29 records)
- catalogs: https://bdl-lang.org/ai-corpus/catalogs.jsonl (23 records)
- preserved_index: https://bdl-lang.org/ai-corpus/preserved-index.json (712 records)
- source_index: https://bdl-lang.org/ai-corpus/source-index.json (216 records)
- supersession_map: https://bdl-lang.org/ai-corpus/supersession-map.json (2 records)

## Authority
1. Current Source
2. Runtime/Test Evidence
3. Verified Artifact/SHA/Diff
4. Last Verified Closure
5. Historical Docs

## Hard prohibitions
- Never guess native IDs
- Never infer Runtime Support from a model property
- Never use direct SQL mutation as a BDL workaround
- Never silently drop unsupported properties
- Never emulate deferred Selective Export by filtering full export
- Never auto-approve destructive mutation
- Never claim Build PASS as Runtime Verified

## Mandatory authoring pipeline
1. Requirement decomposition
2. Shared/Core reuse check
3. Artifact selection
4. Pattern selection
5. Capability and known-gap lookup
6. Live metadata resolution
7. Minimal BDL authoring
8. Parser/Preflight validation
9. ValidateOnly/Compile
10. Plan and human review
11. Approval where required
12. Governed execute
13. Reload/Post-verify
14. Export/Round-trip evidence

Use Current material first. Preserved/history is indexed for provenance and must not override Current material.