# Agronaut RAG corpus — web sources.
#
# Format:  CATEGORY|URL|LABEL|LICENCE
# LABEL is what the operator sees in a "[source: ...]" citation, so it must name the real work.
# LICENCE records the terms the text is published under; Agronaut is a Digital Public Good, so
# only openly licensed material may be indexed.
#
# Vet a proposed source BEFORE adding it here — it is checked for reachability, substance, topic
# drift and licence in one pass:
#     python -m scripts.corpus_report --candidate "<url>" --label "<expected topic>"
#
# Audit everything currently declared:
#     python -m scripts.corpus_report

# The canonical open-access book of the field: 619 pages, 24 chapters, the source behind
# many of aqua_model's cited coefficients (docs/twin_parameter_dossier.md reads it directly).
# CC BY 4.0 CONFIRMED from the book's own copyright page (ISBN 978-3-030-15943-6,
# DOI 10.1007/978-3-030-15943-6, "Open Access ... Creative Commons Attribution 4.0").
# Indexed via the OAPEN mirror because link.springer.com serves a bot-challenge page to
# automated fetchers; OAPEN serves the identical PDF cleanly (gate: 2576 chunks).
# NOTE: this roughly triples the corpus (1354 -> ~3900 chunks). rag.py's own doctrine says
# the hybrid-retrieval weighting sweep must be RE-RUN after substantial corpus growth —
# see docs/dpg/retrieval_eval — before trusting hybrid to still beat dense-only.
BOOK|https://library.oapen.org/rest/bitstreams/99f9a68d-8f14-4a9b-a2c7-156480324d71/retrieve|Goddek, Joyce, Kotzen & Burnell eds. (2019), Aquaponics Food Production Systems, Springer Open|CC BY 4.0

REVIEW|https://doi.org/10.1007/S10462-024-11003-X|Applications, technologies, and evaluation methods in smart aquaponics: a systematic literature review (Artif Intell Rev, 2024)|CC BY 4.0
SURVEY|https://doi.org/10.1371/journal.pone.0102662|Love et al. (2014), An International Survey of Aquaponics Practitioners, PLOS ONE|CC BY 4.0

# ---------------------------------------------------------------------------------------------
# REFERENCES — real citations, NOT indexed (measured: each contributes 0 retrievable chunks).
#
# Kept here so the bibliographic record survives, removed from the index so they stop costing a
# network fetch per cold start while presenting as citation depth. Verified with corpus_report:
# the MDPI entries return HTTP 403 (their "Access Denied" body was previously being indexed as a
# citable passage), the rest resolve to JavaScript redirect shims of ~11 characters.
#
# Paywalled — publisher blocks automated retrieval (HTTP 403):
#   https://doi.org/10.3390/SU7044199
#   https://doi.org/10.3390/w8100468
#   https://doi.org/10.3390/w9030182
#
# Paywalled — resolve to a redirect shim with no extractable text:
#   https://doi.org/10.1016/J.COMPAG.2022.106785
#   https://doi.org/10.1016/j.aquaculture.2014.09.023
#   https://doi.org/10.1016/j.biortech.2015.01.013
#   https://doi.org/10.1016/j.egypro.2017.12.694
#   https://doi.org/10.1016/j.jclepro.2018.01.037
#   https://doi.org/10.1016/j.jclepro.2019.04.290
#   https://doi.org/10.1109/ACCESS.2019.2953491
#   https://doi.org/10.1109/ICMI60790.2024.10586162
#   https://doi.org/10.4081/ija.2017.1012
#
# ---------------------------------------------------------------------------------------------
# FAO 589 — the canonical small-scale aquaponics reference.
#
# LICENCE NOTE. Published 2014, before FAO adopted Creative Commons (their CC policy applies to
# material from ~Nov 2019 onward). Its grant reads: "FAO encourages the use, reproduction and
# dissemination of material in this information product ... for private study, research and
# teaching, or for use in non-commercial products or services, provided that appropriate
# acknowledgement of FAO as the source and copyright holder is given." That is functionally
# equivalent to CC BY-NC, which the DPG Alliance accepts (it prefers CC BY / CC BY-SA / CC0 but
# does not require them). Note the asymmetry this creates and keep it explicit: Agronaut's CODE is
# MIT, while this part of its knowledge corpus is non-commercial-only. See docs/dpg/CORPUS.md.
FAO|https://openknowledge.fao.org/server/api/core/bitstreams/2ca21047-390f-42cd-bd1d-0c2ebc9c1df2/content|FAO 589 Small-scale aquaponic food production (Somerville et al., 2014)|FAO permissive (educational/non-commercial, attribution)
