Implement DOI priority weight in candidate scoring

- Add DOI presence scoring with 100 points for candidates with DOI
- Increase DOI weight to 20% for articles in final scoring calculation
- Add 10% DOI weight for books in final scoring calculation
- Ensure DOI-verified candidates are prioritized over non-DOI candidates
- CLI testing confirms DOI extraction and priority works correctly

Author: HzaCode

awesome-shell

@@ -0,0 +1 @@
+Subproject commit e5a16262df9b530d04397a57ee2223db42486add

best-of-python

@@ -0,0 +1 @@
+Subproject commit f8401776a8437b88a66e155e60d3a1b55e50b0be

cancer_pain_references.bib

@@ -0,0 +1,348 @@
+@article{Nicholas2019The,
+  doi = "10.1097/j.pain.0000000000001390",
+  title = "The IASP classification of chronic pain for ICD-11: chronic primary pain",
+  author = "Nicholas, Michael and Vlaeyen, Johan W.S. and Rief, Winfried and Barke, Antonia and Aziz, Qasim and Benoliel, Rafael and Cohen, Milton and Evers, Stefan and Giamberardino, Maria Adele and Goebel, Andreas and Korwisi, Beatrice and Perrot, Serge and Svensson, Peter and Wang, Shuu-Jiun and Treede, Rolf-Detlef",
+  journal = "Pain",
+  year = 2019,
+  volume = 160,
+  number = 1,
+  pages = "28-37",
+  publisher = "Ovid Technologies (Wolters Kluwer Health)",
+  url = "https://doi.org/10.1097/j.pain.0000000000001390",
+  type = "journal-article",
+}
+
+@misc{Lee2018World,
+  doi = "10.1093/obo/9780199756797-0174",
+  title = "World Health Organization (WHO)",
+  author = "Lee, Kelley and Fang, Jennifer",
+  journal = "Oxford Bibliographies Online Datasets",
+  year = 2018,
+  publisher = "Oxford University Press (OUP)",
+  url = "https://doi.org/10.1093/obo/9780199756797-0174",
+  type = "dataset",
+  howpublished = "\url{https://doi.org/10.1093/obo/9780199756797-0174}",
+}
+
+@article{Bloom2025HSR25161,
+  doi = "10.6004/jnccn.2024.7345",
+  title = "HSR25-161: Potential Factors Impacting Adherence With National Comprehensive Cancer Network Radiation Therapy Guidelines for Early-Stage Breast Cancer.",
+  author = "Bloom, Rosaleen Duggan and Chen, Wen Hsin and Bolin, Jane Nelson",
+  journal = "Journal of the National Comprehensive Cancer Network",
+  year = 2025,
+  volume = 23,
+  number = 3.5,
+  publisher = "Harborside Press, LLC",
+  url = "https://doi.org/10.6004/jnccn.2024.7345",
+  type = "journal-article",
+}
+
+@article{Paice2023Use,
+  doi = "10.1200/jco.22.02198",
+  title = "Use of Opioids for Adults With Pain From Cancer or Cancer Treatment: ASCO Guideline",
+  author = "Paice, Judith A. and Bohlke, Kari and Barton, Debra and Craig, David S. and El-Jawahri, Areej and Hershman, Dawn L. and Kong, Lynn R. and Kurita, Geana P. and LeBlanc, Thomas W. and Mercadante, Sebastiano and Novick, Kristina L. M. and Sedhom, Ramy and Seigel, Carole and Stimmel, Joanna and Bruera, Eduardo",
+  journal = "Journal of Clinical Oncology",
+  year = 2023,
+  volume = 41,
+  number = 4,
+  pages = "914-930",
+  publisher = "American Society of Clinical Oncology (ASCO)",
+  url = "https://doi.org/10.1200/jco.22.02198",
+  type = "journal-article",
+}
+
+@article{Fallon2018Management,
+  doi = "10.1093/annonc/mdy152",
+  title = "Management of cancer pain in adult patients: ESMO Clinical Practice Guidelines",
+  author = "Fallon, M. and Giusti, R. and Aielli, F. and Hoskin, P. and Rolke, R. and Sharma, M. and Ripamonti, C.I.",
+  journal = "Annals of Oncology",
+  year = 2018,
+  volume = 29,
+  pages = "iv166-iv191",
+  publisher = "Elsevier BV",
+  url = "https://doi.org/10.1093/annonc/mdy152",
+  type = "journal-article",
+}
+
+@article{vandenBeukenvanEverdingen2016Update,
+  doi = "10.1016/j.jpainsymman.2015.12.340",
+  title = "Update on Prevalence of Pain in Patients With Cancer: Systematic Review and Meta-Analysis",
+  author = "van den Beuken-van Everdingen, Marieke H.J. and Hochstenbach, Laura M.J. and Joosten, Elbert A.J. and Tjan-Heijnen, Vivianne C.G. and Janssen, Daisy J.A.",
+  journal = "Journal of Pain and Symptom Management",
+  year = 2016,
+  volume = 51,
+  number = 6,
+  pages = "1070-1090.e9",
+  publisher = "Elsevier BV",
+  url = "https://doi.org/10.1016/j.jpainsymman.2015.12.340",
+  type = "journal-article",
+}
+
+@article{Snijders2023Update,
+  doi = "10.3390/cancers15030591",
+  title = "Update on Prevalence of Pain in Patients with Cancer 2022: A Systematic Literature Review and Meta-Analysis",
+  author = "Snijders, Rolf and Brom, Linda and Theunissen, Maurice and van den Beuken-van Everdingen, Marieke",
+  journal = "Cancers",
+  year = 2023,
+  volume = 15,
+  number = 3,
+  pages = "591",
+  publisher = "MDPI AG",
+  url = "https://doi.org/10.3390/cancers15030591",
+  type = "journal-article",
+}
+
+@article{Knaul2018Alleviating,
+  doi = "10.1016/s0140-6736(17)32513-8",
+  title = "Alleviating the access abyss in palliative care and pain relief---an imperative of universal health coverage: the Lancet Commission report",
+  author = "Knaul, Felicia Marie and Farmer, Paul E and Krakauer, Eric L and De Lima, Liliana and Bhadelia, Afsan and Jiang Kwete, Xiaoxiao and Arreola-Ornelas, H{\'e}ctor and G{\'o}mez-Dant{\'e}s, Octavio and Rodriguez, Natalia M and Alleyne, George A O and Connor, Stephen R and Hunter, David J and Lohman, Diederik and Radbruch, Lukas and del Roc{\'i}o S{\'a}enz Madrigal, Mar{\'i}a and Atun, Rifat and Foley, Kathleen M and Frenk, Julio and Jamison, Dean T and Rajagopal, M R and Knaul, Felicia Marie and Farmer, Paul E and Abu-Saad Huijer, Huda and Alleyne, George A O and Atun, Rifat and Binagwaho, Agnes and Bošnjak, Snežana M and Clark, David and Cleary, James F and Coss{\'i}o D{\'i}az, Jos{\'e} R and De Lima, Liliana and Foley, Kathleen M and Frenk, Julio and Goh, Cynthia and Goldschmidt-Clermont, Pascal J and Gospodarowicz, Mary and Gwyther, Liz and Higginson, Irene J and Hughes-Hallett, Thomas and Hunter, David J and Jamison, Dean T and Krakauer, Eric L and Lohman, Diederik and Luyirika, Emmanuel B K and Medina Mora, Maria E and Mwangi-Powell, Faith N and Nishtar, Sania and O'Brien, Megan E and Radbruch, Lukas and Rajagopal, M R and Reddy, K Srinath and del Roc{\'i}o S{\'a}enz Madrigal, Mar{\'i}a and Salerno, Judith A and Bhadelia, Afsan and Allende, Silvia and Arreola-Ornelas, H{\'e}ctor and Bhadelia, Nahid and Calderon, Mariana and Connor, Stephen R and Fan, Victoria Y and G{\'o}mez-Dant{\'e}s, Octavio and Jim{\'e}nez, Jorge and Ntizimira, Christian R and Perez-Cruz, Pedro E and Salas-Herrera, Isaias Gerardo and Spence, Dingle and Steedman, Mark R and Verguet, St{\'e}phane and Downing, Julia D and Paudel, Bishnu D and Elsner, Maia and Gillespie, James Andrew and Hofman, Karen J and Jiang Kwete, Xiaoxiao and Khanh, Quach Thanh and Lorenz, Karl A and M{\'e}ndez Carniado, Oscar and Nugent, Rachel and Rodriguez, Natalia M and Wroe, Emily B and Zimmerman, Camilla",
+  journal = "The Lancet",
+  year = 2018,
+  volume = 391,
+  number = 10128,
+  pages = "1391-1454",
+  publisher = "Elsevier BV",
+  url = "https://doi.org/10.1016/s0140-6736(17)32513-8",
+  type = "journal-article",
+}
+
+@article{Portenoy1990Breakthrough,
+  doi = "10.1016/0304-3959(90)90004-w",
+  title = "Breakthrough pain: definition, prevalence and characteristics",
+  author = "Portenoy, Russell K. and Hagen, Neil A.",
+  journal = "Pain",
+  year = 1990,
+  volume = 41,
+  number = 3,
+  pages = "273-281",
+  publisher = "Ovid Technologies (Wolters Kluwer Health)",
+  url = "https://doi.org/10.1016/0304-3959(90)90004-w",
+  type = "journal-article",
+}
+
+@article{Hurwitz2014Magnetic,
+  doi = "10.1093/jnci/dju082",
+  title = "Magnetic Resonance--Guided Focused Ultrasound for Patients With Painful Bone Metastases: Phase III Trial Results",
+  author = "Hurwitz, Mark D. and Ghanouni, Pejman and Kanaev, Sergey V. and Iozeffi, Dmitri and Gianfelice, David and Fennessy, Fiona Mary and Kuten, Abraham and Meyer, Joshua E. and LeBlang, Suzanne D. and Roberts, Ann and Choi, Junsung and Larner, James M. and Napoli, Alessandro and Turkevich, Vladimir G. and Inbar, Yael and Tempany, Clare Mary C. and Pfeffer, Raphael M.",
+  journal = "JNCI: Journal of the National Cancer Institute",
+  year = 2014,
+  volume = 106,
+  number = 5,
+  publisher = "Oxford University Press (OUP)",
+  url = "https://doi.org/10.1093/jnci/dju082",
+  type = "journal-article",
+}
+
+@article{vanderPluijm2011Breast,
+  doi = "10.1038/nrendo.2011.18",
+  title = "Breast cancer bone metastases: denosumab or zoledronic acid?",
+  author = "van der Pluijm, Gabri",
+  journal = "Nature Reviews Endocrinology",
+  year = 2011,
+  volume = 7,
+  number = 3,
+  pages = "134-135",
+  publisher = "Springer Science and Business Media LLC",
+  url = "https://doi.org/10.1038/nrendo.2011.18",
+  type = "journal-article",
+}
+
+@article{Kyrgidis2012Denosumab,
+  doi = "10.1016/s0140-6736(12)60764-8",
+  title = "Denosumab in castration-resistant prostate cancer",
+  author = "Kyrgidis, Athanassios and Tzellos, Thrasivoulos-George",
+  journal = "The Lancet",
+  year = 2012,
+  volume = 379,
+  number = 9828,
+  pages = "e50",
+  publisher = "Elsevier BV",
+  url = "https://doi.org/10.1016/s0140-6736(12)60764-8",
+  type = "journal-article",
+}
+
+@article{Wang1996The,
+  doi = "10.1016/0304-3959(96)03147-8",
+  title = "The chinese version of the brief pain inventory (BPI-C): its development and use in a study of cancer pain",
+  author = "Wang, Xin Shelley and Mendoza, Tito R. and Gao, Shuo-Zheng and Cleeland, Charles S.",
+  journal = "Pain",
+  year = 1996,
+  volume = 67,
+  number = 2,
+  pages = "407-416",
+  publisher = "Ovid Technologies (Wolters Kluwer Health)",
+  url = "https://doi.org/10.1016/0304-3959(96)03147-8",
+  type = "journal-article",
+}
+
+@article{Smith2013Therapy,
+  doi = "10.1001/jama.2013.7905",
+  title = "Therapy for Chemotherapy-Induced Peripheral Neuropathy---In Reply",
+  author = "Smith, Ellen M. Lavoie and Pang, Herbert",
+  journal = "JAMA",
+  year = 2013,
+  volume = 310,
+  number = 5,
+  pages = "538",
+  publisher = "American Medical Association (AMA)",
+  url = "https://doi.org/10.1001/jama.2013.7905",
+  type = "journal-article",
+}
+
+@article{Attal2015Pharmacotherapy,
+  doi = "10.1097/01.j.pain.0000460358.01998.15",
+  title = "Pharmacotherapy of neuropathic pain",
+  author = "Attal, Nadine and Bouhassira, Didier",
+  journal = "Pain",
+  year = 2015,
+  volume = 156,
+  number = Supplement 1,
+  pages = "S104-S114",
+  publisher = "Ovid Technologies (Wolters Kluwer Health)",
+  url = "https://doi.org/10.1097/01.j.pain.0000460358.01998.15",
+  type = "journal-article",
+}
+
+@article{Derry2017Oral,
+  doi = "10.1002/14651858.cd012638",
+  title = "Oral nonsteroidal anti-inflammatory drugs (NSAIDs) for cancer pain in adults",
+  author = "Derry, Sheena and Wiffen, Philip J and Moore, R Andrew and McNicol, Ewan D and Bell, Rae F and Carr, Daniel B and McIntyre, Mairead and Wee, Bee",
+  journal = "Cochrane Database of Systematic Reviews",
+  year = 2017,
+  publisher = "John Wiley & Sons, Ltd",
+  url = "https://doi.org/10.1002/14651858.cd012638",
+  type = "reference-entry",
+}
+
+@article{Wiffen2017Oral,
+  doi = "10.1002/14651858.cd012637.pub2",
+  title = "Oral paracetamol (acetaminophen) for cancer pain",
+  author = "Wiffen, Philip J and Derry, Sheena and Moore, R Andrew and McNicol, Ewan D and Bell, Rae Frances and Carr, Daniel B and McIntyre, Mairead and Wee, Bee",
+  journal = "Cochrane Database of Systematic Reviews",
+  year = 2017,
+  volume = 2020,
+  number = 2,
+  publisher = "Wiley",
+  url = "https://doi.org/10.1002/14651858.cd012637.pub2",
+  type = "journal-article",
+}
+
+@article{Bell2017Ketamine,
+  doi = "10.1002/14651858.cd003351.pub3",
+  title = "Ketamine as an adjuvant to opioids for cancer pain",
+  author = "Bell, Rae Frances and Eccleston, Christopher and Kalso, Eija A",
+  journal = "Cochrane Database of Systematic Reviews",
+  year = 2017,
+  volume = 2019,
+  number = 9,
+  publisher = "Wiley",
+  url = "https://doi.org/10.1002/14651858.cd003351.pub3",
+  type = "journal-article",
+}
+
+@article{Hurlow2012Transcutaneous,
+  doi = "10.1002/14651858.cd006276.pub3",
+  title = "Transcutaneous electric nerve stimulation (TENS) for cancer pain in adults",
+  author = "Hurlow, Adam and Bennett, Michael I and Robb, Karen A and Johnson, Mark I and Simpson, Karen H and Oxberry, Stephen G",
+  journal = "Cochrane Database of Systematic Reviews",
+  year = 2012,
+  volume = 2015,
+  number = 4,
+  publisher = "Wiley",
+  url = "https://doi.org/10.1002/14651858.cd006276.pub3",
+  type = "journal-article",
+}
+
+@article{Mahbubani2012The,
+  doi = "10.1080/17441692.2011.652972",
+  title = "The World Health Organization (WHO)",
+  author = "Mahbubani, Kishore",
+  journal = "Global Public Health",
+  year = 2012,
+  volume = 7,
+  number = 3,
+  pages = "312-314",
+  publisher = "Informa UK Limited",
+  url = "https://doi.org/10.1080/17441692.2011.652972",
+  type = "journal-article",
+}
+
+@article{Renny2022Impact,
+  doi = "10.1542/peds.2021-055887",
+  title = "Impact of the 2017 FDA Drug Safety Communication on Codeine and Tramadol Dispensing to Children",
+  author = "Renny, Madeline H. and Jent, Victoria and Townsend, Tarlise and Cerd{\'a}, Magdalena",
+  journal = "Pediatrics",
+  year = 2022,
+  volume = 150,
+  number = 5,
+  publisher = "American Academy of Pediatrics (AAP)",
+  url = "https://doi.org/10.1542/peds.2021-055887",
+  type = "journal-article",
+}
+
+@article{Saxena2020World,
+  doi = "10.1007/978-3-030-39903-0_76",
+  title = "World Health Organization (WHO)",
+  author = "Saxena, Shekhar and Yasamy, M. Taghi",
+  journal = "Encyclopedia of Behavioral Medicine",
+  year = 2020,
+  pages = "2357-2359",
+  publisher = "Springer International Publishing",
+  url = "https://doi.org/10.1007/978-3-030-39903-0_76",
+  type = "book-chapter",
+}
+
+@article{Cherny2009European,
+  doi = "10.1177/0269216309107024",
+  title = "European Association for Palliative Care (EAPC) recommended framework for the use of sedation in palliative care",
+  author = "Cherny, Nathan I and Radbruch, Lukas",
+  journal = "Palliative Medicine",
+  year = 2009,
+  volume = 23,
+  number = 7,
+  pages = "581-593",
+  publisher = "SAGE Publications",
+  url = "https://doi.org/10.1177/0269216309107024",
+  type = "journal-article",
+}
+
+@article{Surges2024Revised,
+  doi = "10.1177/02692163231220225",
+  title = "Revised European Association for Palliative Care (EAPC) recommended framework on palliative sedation: An international Delphi study",
+  author = "Surges, S{\'e}verine M and Brunsch, Holger and Jaspers, Birgit and Apostolidis, Kathi and Cardone, Antonella and Centeno, Carlos and Cherny, Nathan and Csik{\'o}s, {\`A}gnes and Fainsinger, Robin and Garralda, Eduardo and Ling, Julie and Menten, Johan and Mercadante, Sebastiano and Mosoiu, Daniela and Payne, Sheila and Preston, Nancy and Van den Block, Lieve and Hasselaar, Jeroen and Radbruch, Lukas",
+  journal = "Palliative Medicine",
+  year = 2024,
+  volume = 38,
+  number = 2,
+  pages = "213-228",
+  publisher = "SAGE Publications",
+  url = "https://doi.org/10.1177/02692163231220225",
+  type = "journal-article",
+}
+
+@article{Dowell2022CDC,
+  doi = "10.15585/mmwr.rr7103a1",
+  title = "CDC Clinical Practice Guideline for Prescribing Opioids for Pain---United States, 2022",
+  author = "Dowell, Deborah and Ragan, Kathleen R. and Jones, Christopher M. and Baldwin, Grant T. and Chou, Roger",
+  journal = "MMWR. Recommendations and Reports",
+  year = 2022,
+  volume = 71,
+  number = 3,
+  pages = "1-95",
+  publisher = "Centers for Disease Control MMWR Office",
+  url = "https://doi.org/10.15585/mmwr.rr7103a1",
+  type = "journal-article",
+}
+
+@article{IDC2025Knowledge,
+  doi = "10.1186/s12912-025-03474-2",
+  title = "Knowledge and attitudes on cancer pain management among nurses at National Cancer Institute Sri Lanka",
+  author = "IDC, Gunathilaka and GY, Walpola and KLMD, Seneviwickrama",
+  journal = "BMC Nursing",
+  year = 2025,
+  volume = 24,
+  number = 1,
+  publisher = "Springer Science and Business Media LLC",
+  url = "https://doi.org/10.1186/s12912-025-03474-2",
+  type = "journal-article",
+}