Initial sanctuary sources

Farming/canaplia/docs/canaplia_codex_survival_obtainment.md

@@ -0,0 +1,29 @@
+# Canaplia survival obtainment tables for Codex
+
+These files describe how already-implemented hemp crops can be obtained in survival.
+
+## Design summary
+- The crop blocks and item variants already exist in the mod.
+- The missing part is the survival obtainment loop.
+- Wild green variants are discovered from biome flora.
+- Colorful variants mostly come from breeding / mutation.
+- `lunar` is a timed special harvest.
+- `ember` is Nether-only.
+- `indigo` is End-only.
+
+## Files
+- `canaplia_codex_variants_catalog.csv`: one row per variant
+- `canaplia_codex_discovery_sources.csv`: world blocks / plants that can drop seeds
+- `canaplia_codex_hybrid_rules.csv`: breeding and mutation outputs
+- `canaplia_codex_special_rules.csv`: night / Nether / End rules
+- `canaplia_codex_survival_obtainment.xlsx`: workbook version of the same data
+
+## Intended Codex usage
+Use these files as the survival design source-of-truth for:
+- loot/drop tables for biome flora
+- breeding logic between mature adjacent crops
+- special timed harvest rules
+- dimension-exclusive obtainment rules
+
+## Internal key alignment
+- Runtime enum keys must match the mod item/block ids: use `pink` instead of `rosy`, and `varieg` instead of `variegated`.